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PREFACE 


he SQL Language Reference Manual contains a complete description 

of the SQL relational database language, which is used to create, 
store, modify, retrieve, and manage information in an ORACLE 
database. 


The language described in this Manual is the SQL as implemented by 
Oracle Corporation for ORACLE Version 6 and is a superset of the 
American National Standards Institute (ANSI) and the International 
Standards Organization (ISO) SQL standard. 


This Manual includes embedded SQL for use in the ORACLE 
Precompilers. For additional information on embedded SQL, refer to 
the Programmer's Guide to the ORACLE Precompilers manual. For 
information on PL/SQL, ORACLE’s procedural language extension to 
SQL, refer to the PL/SQL User's Guide and Reference manual. 
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Audience This Manual is intended for technical professionals and computer 


programmers as well as for non-programmers who want to use SQL. 


How to Use this This Manual is divided into the following chapters: 
Manual 
Chapter 1 "The Relational Model" describes the basic 
concepts of relational theory. 
Chapter 2 “Introduction to SQL" describes the history of SQL 


as well as the advantages of using this language to 
access relational databases. 


Chapter 3 "Elements of the SQL Language” describes the 
basic building blocks of an ORACLE database and 
the ORACLE SQL language. 

Chapter 4 “Operators and Functions" describes the operators 
and functions used within SQL. 

Chapter 5 "SQL Statement Reference" lists and describes all 
of the SQL commands in alphabetical order. 

Chapter 6 "SELECT Statement Clauses” provides more detail 
for the SELECT statement. 

Appendix A "Data Dictionary" summarizes the tables and 


views which comprise the ORACLE catalog. 
Appendix B "SQL Syntax" provides a summary of SQL syntax. 


The glossary defines terms and concepts associated with the SQL 
language. 


Related Publications Manuals associated with the ORACLE Relational Database 


it 


Management System are: 


* ORACLE RDBMS Database Administrator's Guide, Part No. 3601-V6.0 
+ SQL Language Reference Manual (this Manual), Part No. 778-V6.0 
+ SQL Language Quick Reference, Part No. 5421-V6.0 ; 

* SQL Language Tutorial, Part No. 5070-V6.0 

+ PL/SQL User's Guide and Reference, Part No. 800-V6.0 

+ ORACLE Utilities User's Guide, Part No. 3602-V6.0 

* ORACLE Error Messages and Codes Manual, Part No. 3605-V6.0 

+ ORACLE RDBMS Performance Tuning Guide, Part No. 5317-V6.0 

+ Programmer's Guide to the ORACLE Precompilers, Part No. 5135-V1.3 
+ Programmer's Guide to the ORACLE Call Interfaces, Part No. 5411-V6.0 
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Conventions Used in 
this Manual 


Keywords 


Parameters 


The following table describes the syntax notation conventions used in 
this Manual, with an example of each feature. Other words are 
explained where they are used if their meaning is not explained by the 





context. 

Representation Example of 

shown in syntax what toenter Explanation 

ANY_WORD CREATE Displayed in uppercase. Enter text 
exactly as shown, except that it 
need not be in uppercase. 

any_word tablename Displayed in lowercase within the 
syntax description of a command. 
Substitute an appropriate value. 
Displayed in italics in this 
document. 

c T Single character. 

text or char ‘databasel’ Character constant: a literal in 
single quotes or an expression of 
CHAR datatype. For the syntax 
description of text, refer to Chapter 
3 "Elements of the SQL Language" 
of this Manual. 

condition NAME >’A’ — Condition of unspecified format. 
For the syntax description of 
condition, refer to Chapter 4 
"Operators and Functions" of this 
Manual. 

dore ‘01-Jan-88’ Date constant or an expression of 
DATE datatype. 

expr SAL + 1000 Expression of unspecified data- 
type. See expression. 

morn 15*7 Number constant or an expression 
of NUMBER datatype. 

number 112 Number constant or an expression 
of NUMBER datatype. 

raw - Expression of datatype RAW. 

rowid 00000462.0001.0001 


Expression of datatype ROWID. 
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Punctuation. 


Representation 
shown in syntax 


Example of 
what to enter 


Explanation 





query 


braces 


brackets 


parentheses 


three periods 


underline 
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SELECT ’x’ 
FROM DUAL 


{UNION | 
MINUS | 
INTERSECT } 


[NOT | 
AND | OR] 


POWER(n,m) 


name,name,... 


order | noorder 


ASELECT statement contained 
within another SQL statement. 
May contain any SELECT clause 
except ORDER BY or FOR 
UPDATE OF. For the syntax 
description of query, refer to 
Chapter 6 "SELECT Statement 
Clauses" of this Manual. 


Enclose required item. You must 
enter one of the items from the list 
of items separated by the vertical 
bars. Do not enter the braces or 
the vertical bars. 


Enclose optional item. You may 
enter one item from the list of 
items separated by the vertical 
bars. Do not enter the brackets or 
the vertical bar. Lists of only one 
item do not have a vertical bar. 
Enclose parameter lists. 
Parentheses and commas should 
be entered exactly as shown. 
Follow parameter lists. Preceding 
item may be repeated a variable 
number of times. 

Indicates a default value. If you 
enter nothing, ORACLE will use 
this value. 


Your Comments Are 
Welcome 


We value and appreciate your comments as an ORACLE user and 
reader of the manuals. As we write, revise, and evaluate, your opinions 
are the most important input we receive. At the back of this Manual is a 
Reader’s Comment Form which we encourage you to use to tell us both 
what you like and what you dislike about this (or other) Oracle 
manuals. If the form has been used, or you would like to contact us, 
please use the following address, or call us at (415) 598-8000. 


ORACLE RDBMS Product Manager 
Oracle Corporation 

500 Oracle Parkway 

Redwood Shores, CA 94065 
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THE RELATIONAL 
MODEL 


| chapter briefly describes the major concepts of relational theory 
and: 
* provides a basic understanding of table design 
* presents the background information necessary to understand 
the clauses of the CREATE TABLE command 
This chapter covers the following topics: 


* the Entity-Relationship model 


* logical table structure, including the meaning of the terms 
TABLE, COLUMN, ROW 


* physical and logical data independence 
* primary, foreign, and unique keys 
+ referential integrity 


At the end of the chapter are the example tables used throughout this 
manual for purposes of demonstrating SQL usage. 
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Entity-Relationship Model 


1-2 


The Entity-Relationship model is often used when mapping a 
real-world system to a Relational Database Management System 
(RDBMS). Portions of this chapter are based on this model. 


The Entity-Relationship model categorizes all elements of a system as 
either an entity (a person, place, oz thing) ora relationship between 
entities. Both constructs are represented by the same structure, a table. 
For example, in an order-entry system, parts are entities, as are orders. 
Both part and order information is represented in tables. The 
relationship of which parts are requested by which order is also 
represented by a third table. 


The application of the Entity-Relationship model requires the following 
steps. First, identify the entities of your system and construct a table to 
represent entity. Second, identify the relationships between the entities 
and either extend the current tables or create new tables to represent 
these relationships. Third, identify attributes of each entity and extend 
the tables to include these attributes. 


When modeling a system with the Entity-Relationship model you will 
often include a step called normalization. Normalization is the process 
of ensuring that a table has a complete primary key and that all the 
non-primary key columns depend on the entire primary key (Refer to 
the section "Primary Keys" later in this chapter). A comprehensive 
discussion of normalization is ou:side the scope of this manual. You 
may find descriptions of normalization in most relational database 
texts. 


The proper application of the Entity-Relationship model results in 
well-designed tables. The benefits of a set of well-designed tables 
include: 


+ reduced storage of redundant data, which eliminates the cost 
of updating duplicates and avoids the risk of inconsistent 
results based on duplicates 

+ increased ability to effectively enforce integrity constraints 


+ increased ability to adapt to the growth and change of the 
system 

+ increased productivity based on the inherent flexibility of 
well-designed relational systems 


Oracle’s products for database design, CASE*Dictionary, 
CASE*Method, and CASE*Designer can help improve, automate, and 
document designs. See the CASE manuals for additional information. 
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SSSR ET TTR 
Logical Table Structure 


Tables 


Guidelines for Creating 
Tables 


A table is the data structure that holds data ina relational database. A 
table is comprised of rows and columns. 


A table can represent a single entity that you wish to track within your 
system. Such a table might represent a list of the employees within 
your organization or the orders placed for your company’s products. 


A table can also represent a relationship between two entities. Such a 
table could be used to portray the association between employees and 
their job skills or the relationship of products to orders. Within the 
tables foreign keys (also described later in this chapter) are used to 
represent relationships. 


Although some well-designed tables may represent an entity and 
describe the relationship between that entity and another entity, most 
tables should represent either an entity or a relationship. For example, 
the EMP table (listed at the end of this chapter) describes the employees 
ina firm, but this table also includes a foreign key column, DEPTNO, 
which represents the relationship of employees to departments. 


The formal name for a table is a relation (hence the name Relational 
Database Management System) although the use of "table" is more 
common. The advantages of using a table to model data are many: 


* The column/row format of a table is a familiar means of 
visualizing data. 
* Physical pointers are not created to represent relationships. 
The data itself is used to represent the relationship between the 
data. Consequently, the data is usually easier to understand. 
Tables and table operations are well defined because relational 
theory is founded in set theory, relational algebra and 
relational calculus. 


The following guidelines are based on the Entity-Relationship model as 
well as practical experience: 


+ Use descriptive names for tables, columns, indexes, and clusters. 

* Be consistent in abbreviation and in the use of singular and 
plural forms of table names and columns. For additional 
guidelines for naming database objects, refer to Chapter 3 
"Elements of the SQL Language" of this Manual. 

* Create only those columns that are necessary to describe the 
entity or relationship that is to be modelled. Tables with fewer 
columns are easier to use. 
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Columns 


Order of Columns 


+ Create a primary key for every table. 
« Avoid duplication of data across and within tables (normalize). 


+ Document the meaning of each table and its columns with the 
COMMENT statement. 


+ Create a unique index for the primary key of the table. 


Each column of the table represents one (and only one) attribute of the 
entity. For instance, the employee table contains the columns EMPNO, 
ENAME, SAL, and DEPTNO, which represent an employee's ID 
number, name, salary, and department number respectively. 


The name of the column should indicate its meaning. A column should 
not have any hidden meanings. Consequently, you should not use a 
single column to represent multiple attributes. For example, a serial 
number of a car could be composed of make, model, year, color, and 
assembly plant number. Each attribute (make, model, etc.) should have 
its own column rather than a single column which combines all the 
attributes into a single, serial number. 


The advantages of more numerous, shorter columns over single, wider 
columns become clearer over time as users attempt to use the data, in 
ways unforeseen originally. For example, the use ofa column called 
SERIAL_NO would hide the fact that the column represents attributes 
such as make, model, and model year. 


You identify a column by its name, not by its position. If you wish to 
query all employee ID numbers and names, you select the EMPNO and 
ENAME columns, not the first and second columns. 


In non-relational database management systems, a column is often 
called a field. 


The internal order of columns within a table is insignificant. In fact, 
you never need to know the physical order of the columns. Your 
primary concern should be the order in which the columns are returned 
when you query the table. 


You specify the order in which to display the columns through the 
order in which you name the columns in the SELECT list of the 
SELECT statement (as defined in Chapter 5 "SQL Statement Reference” 
of this Manual). Of course, the display order of columns within a given 
query does not change the internal order of the columns as they are 
physically stored within the table. 
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Static Nature of Columns 


Rows 


In using ORACLE tables, you may notice that the columns do not 
change position. While this is generally true, the columns are not 
guaranteed to remain in the same place. This is one reason that you 
should not consider the physical order of columns significant. 


The order in which you specify columns when creating a table does 
affect the order in which the columns are displayed when you use the 
SELECT * construct of a query. In addition, ORACLE expects the 
columns in this same order when you insert rows into a table, unless 
you explicitly specify otherwise. 


The number of columns in a table typically remains constant. The 
columns of a table remain constant because the entity or relationship 
that you wish to model has been well defined and you have decided 
what attributes you wish to monitor. 


Of course, no matter how well you define an entity or relationship, 
your data is not static and will change over time. The ALTER TABLE 
statement makes it very easy to add or modify columns. For instance, if 
your employees are doctors who might need to be contacted at night, 
you may decide that you need to add a column called 
HOME_PHONE_NUMBER to your employee table. The ALTER 
TABLE statement allows you to dynamically add a column to the 
employee table without unloading and reloading the data. 


Rows store the data of a table. Each row represents one occurrence of 
the entity or relationship represented by the table. In the employee 
table, each row is one employee. 


Rows should not be duplicated within a table. Primary keys are 
designed to prevent this duplication. The employee table is defined 
such that a given employee may only occupy one row of the table. In 
the EMPLOYEE_RAISE table (listed in the section "Example Tables" 
later this chapter), each row is one raise for one employee for a given 
date. A given employee will appear in multiple rows of the 
EMPLOYEE_RAISE table, but the combination of EMPNO, 
RAISE_DATE, and SALARY_RAISE_AMOUNT will never be 
duplicated. 
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Order of Rows 


Dynamic Nature of Rows 


Value 


The internal order of rows in a table is insignificant. In fact, you never 
need to know the internal order of the rows. You do not have to insert 
rows into a table in any particular order. Your primary concern should 
be the order in which the rows are returned when you query the table. 


You use the ORDER BY clause in a query when you want to display the 
rows ina specific order. Without the ORDER BY clause, the rows are 
returned in an order convenient to ORACLE, and you should not rely 
on the ORACLE-determined order to be consistent from query to 
query. Of course, the display order of rows within a given query does 
not affect the internal order of the rows as they are actually stored 
within the table. 


In mathematical terms, a table is very similar to an unordered set, 
without a beginning or an end. You achieve logical data independence 
(see following sections on data independence) by not relying ona fixed 
internal ordering of a table’s rows. 


In using ORACLE tables, you may notice that the rows rarely change 
position. Even though the rows do not arbitrarily move around, your 
queries should always use the ORDER BY clause when order is 
important. 


While the number and the names of columns in a table will remain 
relatively static over time, the number of rows ina table is likely to be 
quite dynamic. For example, if the EMP table represents people who 
work in your organization, then each row in the EMP table represents 
one such person. The rows of the EMP table will increase and decrease 
as your firm hires and retires employees. 


Some tables never shrink, but always increase. One important step in 
modeling your system is an estimation of how much space a table will 
use over time. You may have to plan for the periodic archiving of data 
for your large tables. 


The formal relational term for a row isa tuple. A row is roughly 
equivalent to a record as defined in other types of database 
management systems. 


A value is the data referenced by the intersection of a given row and 
column. The value assumes the datatype of its column and may be null 
(datatypes and NULL are discussed in Chapter 4 "Elements of the SQL 
Language” of this Manual). 
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Views 


A view is a logical representation of another table or combination of 
tables. A view derives its data from the tables on which it is based, 
These tables are called base tables. Base tables may in turn be actual 
tables or may be views themselves. 


You may use views in almost all the same ways as tables. Views may 
be queried, updated, inserted into, and deleted from, just as with 
standard tables. 


Views do not actually contain data; rather, they derive their data from 
their base tables. All operations performed on a view actually affect the 
base table of the view. 


Views provide a means to present a different representation (such as 
subsets or supersets) of the data that resides within other tables and 
views. Views are very powerful because they allow you to tailor the 
presentation of data to different types of users. 


Views are used for the following purposes: 


* to provide an additional level of table security by restricting 
access to a predetermined set of rows and/or columns of a 
table. For example, a single view can be created which will 
display eastern sales data to the Eastern regional manager, 
western sales data to the Western regional manager, and all the 
sales data to the National sales manager, from the same base 
table. 


to hide data complexity. For example, a single view may be 
used to return rows from multiple tables, so users need only 
remember the name of the view. 


to reduce syntactic complexity. For example, views allow users 
to select information from multiple tables without actually 
knowing how to perform the join operation. 

to present the data from another perspective, For example, 
views provide a means to rename columns without actually 
affecting the table(s) on which the view is based. 

+ to provide a level of referential integrity. Refer to the section 
“Referential Integrity" later in this chapter and to the WITH 
CHECK option of the CREATE VIEW statement in Chapter 5 
"SQL Statement Reference" of this Manual. 
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Indexes 


Provide Quick Access 


Enforce Uniqueness 


Clusters 


Indexes are used for two purposes in ORACLE relational database 
management systems: 


+» Indexes provide quick access to rows ina table. 
+ Indexes enforce uniqueness of rows within a table. 


Indexes provide faster access to data for operations that return a small 
portion of a table’s rows. For example, an index on the EMPNO 
column of the EMP table allows ORACLE to directly access employee 
number 7544, rather than scan the entire table for the same employee. 


ORACLE does not limit the number of indexes you can create ona 
table. However, you should use this rule of thumb to determine which 
column(s) to index. 


Rule of thumb: SQL statements that query less than 10% or 15% of a 
table’s rows may complete faster when an index is used. Fora 
discussion of the performance benefits of indexes, refer to Chapter 2 
"Tuning SQL Statements and Applications" of the ORACLE RDBMS 
Performance Tuning Guide. Fora general discussion of indexes, refer to 
Chapter 5 "User Database Objects" of the ORACLE RDBMS Database 
Administrator's Guide. 


Unique indexes also enforce the requirement that rows not be 
duplicated within a table. Generally, you should create a unique index 
on the primary key of every table. On rare occasions, business reasons 
might dictate that you store duplicate rows ina table. For this reason, 
ORACLE does not require you to create a unique index for every table. 


Clustering is a means of structuring the data in one or more tables so 
that the rows are physically close to one another. Clustering is 
beneficial if your application frequently selects the same grouping of 
rows from a table or tables. For example, if you always process 
employees by department number, it would be beneficial to cluster the 
employee table by department number. 


While clustering may improve the performance of certain operations, 
clustering may also decrease performance of others. For a discussion of 
the performance benefits of clusters, refer to Chapter 2 "Tuning SQL 
Statements and Applications" of the ORACLE RDBMS Performance 
Tuning Guide. For a general discussion of clusters, refer to Chapter 5 
"User Database Objects" of the ORACLE Database Administrator's Guide. 
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Physical Data 
Independence 


The use of indexes and clusters is transparent to users. The ORACLE 
RDBMS uses them when it is beneficial to the current operation. You 
do not need to modify a given SQL query to take advantage of an index 
or cluster. The ORACLE query optimizer is aware of all indexes and 
clusters for a table and uses them when appropriate. The transparent 
feature of indexes and clusters is called physical data independence; the 
underlying format of the data can change (i.e., the table may be 
clustered or unclustered), but the user’s application requires no change. 


Data Independence 


Physical Data 
Independence 


Logical Data 
Independence 


Physical data independence is the separation of the way the data is 
physically stored from the arrangement of the data as presented to the 
user. To the computer, the data is stored as a series of ones and zeros, 
but to the user, the data is arranged in rows and columns, and these 
rows and columns are contained in tables. 


One advantage of physical data independence is that your application 
will need no modification even if the physical storage of the data 
changes. For example, your database administrator may decide to 
cluster the EMP table with the DEPT table. All the queries that select 
from the EMP or the DEPT table will continue to return the same 
results regardless of clustering. 


Another benefit of physical data independence is that you do not need 
to know the access paths to the data in order to select from a table. 
ORACLE knows if a table has indexes and uses all appropriate indexes 
when resolving your query. Your query will work whether or not the 
table has indexes. 


Logical data independence results from the arbitrary order of columns and 
rows ina table. You do not need to physically manipulate pointers to 
access the data. You find a column by its name and a row by the value 
of its primary key. For information on keys, refer to the next section 
"Keys." Thus even though the order of the columns or rows ina table 
may change, a query on that table will continue to return the same 
results. In addition, columns may be added to or subtracted from a 
table with no impact on existing queries unless the queries reference 
the subtracted columns. 


Logical data independence also results from the use of views. Views 
can shield the logical structure of the data from the users that access the 
view. For example, one view can be used to transparently retrieve data 
from several tables. 
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Keys 
Primary Keys 


A primary key of a table is used to uniquely identify each row in the 
table and is comprised of one or more columns of a table. The value of 
the primary key uniquely identifies one row of a table. Thus, for every 
primary key value there is exactly one row and for every row there is 
exactly one primary key value. 


A primary key may be comprised of any of a table’s columns; 
Generally, the primary key is listed first within a CREATE TABLE 
statement. 


A multi-column primary key is called a composite primary key. The 
following discussion applies to both single and composite primary 
keys. 


As previously mentioned, a table is an unordered set. Because a table is 
unordered, you cannot request the fifth row of the table; instead you 
use the table’s primary key to select a specific row. If DEPTNO is the 
primary key of the DEPT table {as listed at the end of this chapter), then 
a request for department number 30 will always return the one row 
corresponding to Department 30. 


Although ORACLE does not require you to specify a primary key fora 
table, all tables should have one (and only one) primary key. If a table 
does not have a primary key, it may contain duplicate rows. A primary 
key is created in the column constraint and table constraint clauses of the 
CREATE TABLE statement. 


The following guidelines will help you choose primary keys: 


1. You should choose a column or columns for the primary key whose 
data values will remain unique, as primary key values should 
never change. 


2. Ordinarily, you should not modify a row’s primary key value. 


The only function that a primary key performs is to uniquely 
identify a row and thus, one identifier is as good as another. 
Primary keys have no other inherent meaning. 


Data inconsistency is the primary danger in allowing a primary 
key value to change. Relationships between entities are most often 
represented through primary keys. Changing a primary key value 
destroys these relationships unless corresponding updates are 
made in all places where the primary key value is referenced. It is 
often difficult to guarantee that all the proper updates are made. 


1-10 SQL Language Reference Manual 





Foreign Keys 


3. You should create primary keys that are short and numeric. Short 
primary keys are easier to type and numeric keys make it easy to 
assign the next primary key value. For example, if the last primary 
key value was 115 and the primary key is ascending, then it is 
reasonable to assume that 116 is the next primary key value. 


Foreign keys represent relationships between tables. A foreign key isa 
column (or group of columns) whose values are derived from the 
primary key of another (or same) table. The existence of a foreign key 
implies that the table with the foreign key is related to the primary key 
table from which the foreign key is derived. 


A composite foreign key is a foreign key composed of multiple columns. 


For example, the DEPTNO column is the primary key of the DEPT 
table (as described at the end of this chapter). The DEPTNO column of 
the EMP table (also described at the end of this chapter) is a foreign key 
referencing the DEPT table. The foreign key DEPTNO of the EMP table 
represents the relationship between employees and departments. The 
DEPTNO foreign key column of the EMP table allows one to determine 
that all department 10 employees work in the ACCOUNTING 
department located in NEW YORK. 


In the remainder of this discussion, the table with the foreign key will 
be referred to as the foreign key table; the table which the foreign key 
references will be referred to as the primary key table. Thus, EMP is the 
foreign key table, and DEPT is the primary key table. 


A table may contain multiple foreign keys. Since each foreign key 
represents a relationship to another table, multiple foreign keys 
represent multiple relationships, The EMP table has two foreign keys, 
DEPTNO and MGR. 


A foreign key can reference the primary key of the same table. MGR 
references the primary key of the EMP table. The MGR foreign key 
represents the relationship between employees and managers. The 
employee JONES has a value of 7839 for MANAGER. Because KING 
is employee 7839, you know that KING is JONES’ manager. 


A foreign key value should have a corresponding primary key value in 
the primary key table to have meaning. For example, if an employee of 
the EMP table has a department number of 40, then department 40 
must exist in the DEPT table. 
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Unique Keys 


A foreign key must be comprised of the entire primary key from which 
it is derived. If, for example, you wish to relate employees to offices, 
and the columns FLOOR_NUMBER and OFFICE_NUMBER form the 
composite primary key of the OFFICE table, then it would be incorrect 
to include just FLOOR_NUMBER or just OFFICE_NUMBER as a 
foreign key in the EMP table. 


A foreign key value may be null. For example, a new employee may 
have yet to be assigned a department and consequently may have a 
null value for DEPTNO. 


A foreign key may have duplicate values. For example, it is reasonable 
to expect that more than one employee of the EMP table can have the 
same department number. 


A foreign key is created with CREATE TABLE statement (as defined in 
Chapter 5 "SQL Statement Reference” of this Manual). Specifically, you 

will use the REFERENCES clause of column constraint column element 
or the FOREIGN KEY clause of the table constraint table element. 


A unique key has all the properties of a primary key except that a unique 
key fulfills a different function. A column defined as a unique key must 
havea distinct value for each row of the table. A unique key should not 
have nulls, and consequently, the NOT NULL constraint must 
accompany the UNIQUE constraint. 


In contrast to the function of a primary key, which is used to identify 
each row of a table, the function of a unique key is to ensure 
unique-ness. For example, your business may dictate that every 
employee have a distinct telephone number. The 
TELEPHONE_NUMBER column should therefore be defined to bea 
unique key. 


Note that although you could use TELEPHONE_NUMBER as the 

rimary key, it is more appropriate that a system-generated key, such 
as EMPLOYEE_NUMBER be used for the primary key. A system- 
generated employee number serves as a better primary key than a 
telephone number because: 


1. A primary key should not connote any information besides 
uniquely identifying a given row. A telephone number represents 
the numbers to dial to call an employee's telephone. 


2. A primary key should remain constant. Asan employee moves 
within the organization, his telephone number may change. 
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Referential Integrity 


In contrast to primary keys, a table may have multiple unique keys. A 
unique key can also be composed of multiple columns, a composite 
unique key. 


Examples of unique keys that are not primary keys include: 


* a truck’s license plate number (the truck’s primary key is the 
truck number) 


* anemployee’s social security number (the employee’s primary 
key is employee number) 


Referential integrity is a desirable property of a relational database 
management system to enforce. Specifically, referential integrity 
ensures that relationships represented by primary and foreign keys 
are maintained. 


An integrity constraint is a rule that enforces a relationship within your 
system. For example, one integrity constraint in our sample Human 
Resource system states that an employee in the EMP table may not be 
assigned a department that does not exist in the DEPT table. Another 
similar referential integrity rule for the EMP table is that the manager 
number for an employee must be the employee number of another 
employee in the EMP table. 


The primary benefit of referential integrity is data consistency. Within 
ORACLE, referential integrity is defined in the same statement that 
defines a table or view (CREATE TABLE and CREATE VIEW 
statements). This means that referential integrity can be defined at the 
instant of table creation and that integrity constraints are enforced 
regardless of the application or tool that accesses the table. 


Note: The definition of integrity constraints is supported in ORACLE 
Version 6.0; the enforcement of integrity constraints is not yet supported. 


Integrity constraints are stored in the ORACLE Data Dictionary. Users 
and applications may query the data dictionary to determine the 
integrity constraints placed ona given table. 


The foreign key is the mechanism for supporting referential integrity. 
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Table and Column Constraints 
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ORACLE Version 6.0 contains syntax support for integrity constraints 
as defined by the ANSI SQL Standard Addendum I. 


Integrity constraint definitions are stored in the Data Dictionary. 
Consequently, these definitions allow an application designer to 
constrain the range of acceptable values that may be inserted into a 
table. 


‘A column constraint is associated with a single column. A table 
constraint can be associated with one or more columns. 


Constraints can take the following forms: 


- aNOTNULL restriction. The column may not contain a null 
value. For information on null values, refer to Chapter 3 
“Elements of the SQL Language" of this Manual. 

+ a UNIQUE restriction. The column or columns may not 
contain duplicate values. 

+ a PRIMARY KEY restriction. The column or columns comprise 
the primary key and as such may not contain duplicates. 
PRIMARY KEY implies UNIQUE, but UNIQUE does not 
imply PRIMARY KEY. A table may only have one PRIMARY 
key, but can have multiple UNIQUE columns. PRIMARY KEY 
also implies NOT NULL. 

- aFOREIGN KEY restriction. The column or columns comprise 
a foreign key and as such must reference a primary key of a 
specified table. 

+ a CHECK restriction. Before a row is inserted or updated, the 
row must satisfy the expression defined by the CHECK 
constraint. 


Note: ORACLE Version 6.0 fully supports the NOT NULL constraint. 
The current WITH CHECK OPTION clause of the CREATE VIEW 
statement supports additional forms of referential integrity. Indexes 
are currently used to enforce the UNIQUE constraint. 


For a complete discussion of constraints, refer to the section "Constraint 
clause" of Chapter 5 "SQL Statement Reference" of this Manual. 
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Example Tables 
EMP Table 


DEPT Table 


EMPLOYEE_RAISE 
Table 


DUAL table 


EMPNO ENAME JOB 





7499 ALLEN SALESMAN 
7521 WARD SALESMAN 
7566 JONES MANAGER 
7654 MARTIN SALESMAN 
7698 BLAKE MANAGER 
7782 CLARK MANAGER 
7788 SCOTT ANALYST 
7839 KING PRESIDENT 
7844 TURNER SALESMAN 
7876 ADAMS CLERK 
7900 JAMES CLERK 
7902 FORD ANALYST 
7934 MILLER CLERK 


MGR 


7902 
7698 
7698 
7839 
7698 
7839 
7839 
7566 


7698 
7788 
7698 
7566 
77182 


DEPTNO DNAM# Loc 

10 ACCOUNTING NEW YORK 
20 RESEARCH DALLAS 
30 SALES CHICAGO 
40 OPERATIONS BOSTON 


HIREDATE SAL COMM DEPTNO 
17-DEC-80 800 20 
20-FEB-81 1600 300 30 
22-FEB-81 1250 500 30 
02-APR-81 2975 20. 
28-SEP-81 1250 1400 30 
OL-MAY~81 2850 30 
09-JUN-81 2450 10 
10-FEB~88 3000 20 
17-Nov-81 5000 10 
08-SEP~81 1500 30 
15~MAR-88 1100 20 
03-DEC-81 950 30 
03-DEC-81 3000 20 
23-JAN-82 1300 10 


EMPNO RAISE_DATE SALARY RAISE AMOUNT 


7844 03-JAN-82 100 
7876 03-JAN-82 100 
7839 =15-ocT-84 1000 
7844 OL-JAN-83 200 
7902 27-JAN-83 107 


The DUAL table may be used within SELECT Statements that could 
refer to any table. DUAL is often chosen because it has only one column 


and one row. For example, 


SELECT SYSDATE FROM DUAL 
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CHAPTER 


INTRODUCTION TO 
SOL 


S QL is the set of statements that all programs and users must use to 
access data within the ORACLE database. Application programs 
and ORACLE tools often allow users to access the database without 
directly using SQL, but these applications in turn must use SOL when 


executing the user’s request. This chapter provides background 


information on the SQL language used by most relational database 


systems. Topics include: 


° 


history of SQL 

SQL standardization 

benefits of SQL 

National language support 
embedded SQL 

ORACLE SQL lexical conventions 


Introduction to SQL 


Paces a eNOS EER 


History of SOL 


SQL Standardization 


The SQL language was developec in a prototype relational database 
management, System R, by IBM in the mid-1970s. System R was 
described by E.F. Codd in the November 1976 Journal of R&D. In 

1979, Oracle Corporation introduced the first commercially available 
implementation of SQL. SQL has also been implemented in IBM’s DB2 
and SQL/DS database systems. 


The American National Standards Institute (ANSD adopted SQL as 
the standard language for relational database management systems 

in October 1986 (ANSI X3.135-1986). The SQL standard has also been 
adopted by the International Standards Organization (ISO standard 
9075) as well as the U.S. Federal Government, in the Federal 
Information Processing Standard (FIPS) number 127. Recently, the 
Integrity Enhancement Feature described by ANSISQL Addendum I’ 
has been combined with the orig:nal SQL standard and is reissued as 
X3.135-1989 and 9075-1989. All major relational database management 
systems support some form of SQL and most intend to comply with the 
ANSI SQL89 standard. 


SOL is still evolving as a language and some aspects of this language 
have not been defined. For example, the complete definition of 
referential integrity has not yet been finalized by any of the previously 
named standards organizations. 
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ENE 


Benefits of SQL 


Non-procedural Language 


A Language for All Users 


The following sections illustrate many of the reasons for SQL’s 
wide-spread acceptance by relational database vendors as well as end 
users. Its strengths benefit all ranges of users including application 
programmers, database administrators, management, and end users. 


SQL is a non-procedural language because it: 


* processes sets of records rather than just one at a time 
* provides automatic navigation to the data 


SQL allows you to work with higher level data structures, Rather than 
manipulating single records, you manage sets of records. The most 
common form of a set of records is a table (as described in Chapter 1 
"The Relational Model" of this Manual). All SQL statements accept sets 
as input and all SQL statements return sets as output. The set property 
of SQL allows the results of one SQL statement to be used as input to 
another SQL statement. 


SQL does not require you to specify the access method to the data. This 
feature makes it easier for you to concentrate on obtaining the desired 
results. All SQL statements use the query optimizer, one portion of the 
RDBMS, which determines the fastest means of accessing the specified 
data. The query optimizer knows what indexes exist and uses these 
indexes where appropriate; when accessing a table, you need never 
know ifa table has indexes or what types of indexes the table has. 


SQL is used for all types of database activities by all ranges of users 
including: 

* system administrators 

* database administrators 

* application programmers 

* management personnel 

* decision support system personnel 

* many other types of end users 
SQL provides a handful of easy to learn commands that are both 
consistent and applicable for all users. The basic SQL statements can be 


learned in a few hours and even the most advanced statements can be 
mastered in a few days. 
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Unified Language 


Common Language for 
All Relational Databases 


SQL provides statements for a variety of tasks including: 
* querying data 
+ inserting, updating, and deleting rows ina table 
+ creating, modifying, and deleting database objects 
+ controlling access to the database and database objects 
+ guaranteeing database consistency 
Previous database management systems often used a separate 


language for each of the above categories. SQL unifies all these tasks in 
one consistent language. 


Because all major relational database management systems support 
SQL, you can transfer all the skills you have gained with SQL from one 
RDBMS to another. In addition, all programs that you have written in 
SQL are portable — they can be moved from one RDBMS to another 
with very little modification. 


Per aT ac Na aac 


National Language Support 


ORACLE Version 6 provides additional features to enable ORACLE 
installations to operate in various national languages, and to enable 
ORACLE applications to process multi-lingual data stored in one 
ORACLE database. 


Three functions, CONVERT(), NLSSORT() and REPLACE), have 
been added for National Language Support. REPLACE(), although 
important for National Language Support, has a broad range of uses. 
For additional information on these functions, refer to Chapter 4 
"Operators and Functions" of this Manual. 


Many date functions will return different results based on the 
site-specific national language. For example, while Sunday is the 
default first day of the week, other languages specify that Monday is 
the first day of the week. In addition, sorting order may be affected by 
the site-specific national language. 


Currently, a site is supplied with only one language, the language 
appropriate for site. For example, when ORACLE is supplied in 
France, the language is French. 


For a complete description of these features and behaviors, refer to 
Appendix F "National Language Support" of the ORACLE RDBMS 
Database Administrator's Guide. 
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Embedded SOL 


Embedded SQL refers to the use of standard SQL statements embedded 
within a procedural programming language. Embedded SQL is a 
collection of: 

¢ all SQL statements (e.g., SELECT, INSERT) 

* flow control commands (e.g., PREPARE, OPEN) which 
integrate the standard SQL commands within a procedural 
programming language 

Embedded SQL also includes extensions to standard SQL statements. 
Chapter 5 "SQL Statement Reference" presents each statement in 
standard form and then in embedded SQL form, if appropriate. 
Embedded SQL is supported by the ORACLE Precompilers. The 
ORACLE Precompilers interpret embedded SQL and translate the 
embedded SQL statements into statements that can be understood by 
procedural language compilers. 

Each of these ORACLE Precompilers translates embedded SQL 
programs into a different procedural language: 

* the Pro*Ada Precompiler 

* the Pro*C Precompiler 

* the Pro*COBOL Precompiler 

* the Pro*FORTRAN Precompiler 

* the Pro*Pascal Precompiler 

the Pro*PL/I Precompiler 
For a complete definition of each ORACLE Precompiler, refer to the 


Programmer's Guide to the ORACLE Precompilers manual and the 
Supplement to the ORACLE Precompilers Guide specific to each language. 
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Embedded SOL Terms The following embedded SQL terms are used throughout this Manual: 


thost_variable 


cursor_nameé 


AT dbname 


connect_string 


statement_name 


shost_string 
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is a language variable declared according to the 
rules of the procedural language and referenced in 
aSQL statement. A host variable may bea 
predefined type ora user-defined array and may 
include an associated indicator variable. For the 
definition of indicator, refer to the Programmer's 
Guide to the ORACLE Precompilers manual. 


Host variables may be used only where numeric or 
character expressions may appear, and are always 
preceded by a colon (:) to distinguish them from 
column or fable names. Host variables may not be 
used to represent SQL keywords or table or 
column names. 


designates an identifier for an explicit 
(user-declared) SQL cursor. 

is an optional clause that introduces a non-default 
database. This database name must have been 
previously declared ina DECLARE DATABASE 
statement. 


is the database identification string for a SQL*Net 
database connection. For details, refer to the 
SQL*Net User's Guide for each specific SQL*Net 
protocol. 


designates an identifier for a PREPAREd SQL 
statement. 


isa host variable character string (string, varchar, 
etc.) containing the text of a SQL statement. 


[i282 ACEC) 
ORACLE SQL Lexical Conventions 


The following lexical conventions for issuing SQL statements apply 
specifically to Oracle’s implementation of SQL, but are generally 
acceptable in all other SQL implementations. 


When you issue a SQL statement, you may include one or more tabs, 
carriage returns, spaces, or comments anywhere a space occurs within 
the definition of the statement. Thus, ORACLE evaluates the following 
statements in the same manner: 


SELECT ENAME, SAL*12,MONTHS BETWEEN (HIREDATE, SYSDATE) FROM EMP 


SELECT ENAME, 
SAL * 12, 
MONTHS BETWEEN( HIREDATE, SYSDATE ) 
FROM EMP 


Case is insignificant in reserved words, keywords, identifiers and 
parameters. However, case is significant in character string literals. 
Refer to the syntax description of text in Chapter 3 “Elements of the 
SQL Langauge" of this Manual. 
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CHAPTER 


ELEMENTS OF THE 
SQL LANGUAGE 


TT? chapter contains reference information on the basic elements of 
SQL. An understanding of these elements is crucial for effective 
use of SQL. Before using any of the statements detailed in Chapter 5 
"SQL Statement Reference", you should familiarize yourself with the 
concepts covered in this chapter. Topics include: 

» database objects 

* database object naming rules 

* reserved words 

* literals 

* variables 

* datatypes 

* null values 

* pseudo-columns 
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Database Objects 


Database objects are elements that are maintained by an ORACLE 
RDBMS. Most database objects occupy space in the database. Some 
database objects (such as tablespaces) exist to hold other database 
objects. Tables are the only database objects that hold user data and 
which a user can access directly. 


Database objects are given names when created, and these names 
follow the rules for identifiers listed in the following section. All 
database objects have a creator and an owner; normally the creator and 
owner of a database object are the same user. This list contains 
database objects that are named: 

* clusters 

* columns 

* constraints 

» databases 

+ database links 

* indexes 

* rollback segments 

* savepoints 

* sequences 

* synonyms 

+ tables 

» tablespaces 

* users 

« views 
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Database Object Naming Rules 


Below are the rules governing the naming of database objects in the 
SQL language: 


1. 


2 
3 
4 
5 


The name of a database object must be from 1 to 30 characters long 
(except for database names which are limited to 8 characters). 


- Aname may not contain a quotation mark. 

. Anameis not case-sensitive. 

. Aname must begin with a letter. 

. A name may only contain the characters A-Z, 0-9, _~ 4, and # (the 


use of $ and # is discouraged). 


. A name must not duplicate an ORACLE reserved word (see the 


following section on reserved words). 


- Aname must not duplicate the name of another database object 


owned by that user. 


. (indexes, sequences, tables, or views). Some database objects may be 


further qualified with the username of the database object owner. 
For example, instead of EMP, you may use SCOTT.EMP. You may 
include spaces around the period separating the username from the 
database object name, but the spaces are left out by convention. 


. Aname may contain any combination of characters, and thus ignore 


rules 3 through 6, if enclosed in quotation marks. (in this way a 
name could also include a space.) 


Column and table aliases, although not database objects, must follow 
the preceding naming rules as well. 


Examples of identifiers include: 


ENAME 

HORSE 

SCOTT .hiredate 

"SELECT" 

“BVEN THIS & THAT!" 
A_VERY_VERY_VERY_LONG_NAME 
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Database Object Naming Guidelines 
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There are several helpful guidelines for naming database objects: 


+ Use full, descriptive names (or at least well-known 
abbreviations). 


° Use singular names. 
+ Use consistent naming rules. 


+ Use the same name to describe the same entity or attribute 
across tables. 


When you select names for objects you must balance the objective of 
keeping the object name as short as possible (for ease of use) with the 
objective of making the object name as descriptive as possible. If in 
doubt, you should choose the more descriptive name because most 
systems are used by many people over many years. Your counterpart 
ten years in the future will have a difficult time understanding the 
system if you use PMDD instead of PAYMENT_DUE_DATE. 


It is convention to use the singular form for table names. For example, 
tse EMPLOYEE table as opposed to EMPLOYEES table. Or, you may 
choose the opposite convention of using plural forms of names. The 
purpose of either convention is to make it easier to determine the name 
of a table without looking it up. 


The use of consistent naming rules helps users understand the role that 
each table plays in your application. One such rule might be to preface 
all tables that belong to the FINANCE application with FIN_. 


You should use the same names to describe the same things across 
tables. For example, the department number columns of the EMP and 
DEPT tables are both named DEPTNO. 
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Reserved Words 


The following words are reserved in SQL. You may not use them as 


names of database objects unless they are in double quotes. 


Words followed by an asterisk (*) are also ANSI reserved words. 


Words followed by a plus sign (+) are reserved words which are new 


beginning with ORACLE RDBMS Version 6. 


ACCESS 
ADD 
ALL* 
ALTER* 
AND* 
ANY* 
AS* 
ASC* 
AUDIT 


BETWEEN* 
BY* 


CHAR* 
CHECK* 
CLUSTER 
COLUMN+ 
COMMENT 
COMPRESS 
CONNECT 
CREATE* 
CURRENT* 


DATE 
DBA , 
DECIMAL* 


DEFAULT* 
DELETE* 
DESC* 
DISTINCT* 
DROP 


ELSE+ 
EXCLUSIVE 
EXISTS* 


FILE 
FLOAT* 
FOR* 
FROM* 


GRANT* 
GRAPHIC 
GROUP* 


HAVING* 


IDENTIFIED 
IF+ 
IMMEDIATE* 
IN* 
INCREMENT 


INDEX 
INITIAL 
INSERT* 
INTEGER* 
INTERSECT 
INTO* 

Is* 


LEVEL 
LIKE* 
LOCK 
LONG 


MAXEXTENTS 
MINUS 

MODE 
MODIFY* 


NOAUDIT 
NOCOMPRESS 
NOT 

NOWAIT 
NULL* 
NUMBER 


OF*+ 
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OFFLINE+ 
ON* 
ONLINE+ 
OPTION* 
OR* 
ORDER* 


PCTFREE 
PRIOR 
PRIVILEGES* 
PUBLIC* 


RAW 
RENAME 
RESOURCE 
REVOKE* 
ROW 
ROWID 


3-6 SQL Language Reference Manual 


ROWNUM 
ROWS 


SELECT* 
SESSION* 
SET*+ 
SHARE 

SIZE 
SMALLINT* 
START+ 
SUCCESSFUL 
SYNONYM 
SYSDATE 


TABLE* 
THEN+ 
TO* 
TRIGGER+ 


UID 
UNION* 
UNIQUE* 
UPDATE* 
USER* 


VALIDATE 
VALUES* 
VARCHAR* 
VARGRAPHIC 
VIEW* 


WHENEVER*+ 
WHERE* 
WITH* 


The following keywords have special meaning in the SQL language 
supported by ORACLE RDBMS but are not reserved words and thus 
may be used as identifiers. These words may become reserved words in 
the future. ANSI reserved words are indicated by *; keywords added in 
Version 6.0 are indicated by +. 


ARCHIVELOG+ 
AUTHORIZATION*+ 


BACKUP+ 
BEGIN*+ 


CACHE+ 
CHARACTER*+ 
CLOSE*+ 
COBOL*+ 
COMMIT*+ 
CONSTRAINT*+ 
CONTENTS+ 
CONTINUE*+ 
CONTROLFILE+ 
CRASH 
CURSOR*+- 
CYCLE+ 


DATABASE 
DATAFILE+ 
DEC*+ 
DECLARE*+ 
DISMOUNT+ 
DOUBLE*+ 


END*+ 


ESCAPE*+ 
EVENTS+ 
EXEC*+ 


FETCH*+ 
FOREIGN*+ 
FORTRAN*+ 
FOUND*+ 


GOt+ 
GOTO*+ 


INCLUDING+ 
INDICATOR*+ 
INITRANS+ 
INT*+ 


KEY*+ 


LANGUAGE*+ 
LINK 
LOGFILE+ 


MAXDATAFILES+ 
MAXINSTANCES+ 
MAXLOGFILES+ 
MAXTRANS+ 


MAXVALUE+ 
MINEXTENTS+ 
MINVALUE+ 
MODULE*+ 
MOUNT+ 


NEXT*+ 
NOARCHIVELOG+ 
NOCACHE+ 
NOCYCLE+ 
NOMAXVALUE+ 
NOMINVALUE+ 
NOORDER+ 
NORMAL+ 
NOSORT+ 
NUMERIC*+ 


ONLY*+ 
OPEN*+ 


PASCAL*+ 
PCTINCREASE+ 
PCTUSED+ 
PLI*+ 
PRECISION*+ 
PRIMARY*+ 
PROCEDURE*+ 
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READ*+ SEQUENCE+ TABLES+ 


REAL*+ SHARED+ TABLESPACE+ 
REFERENCES*+ SOME*+ TEMPORARY*+ 
RELEASE+ SORT+ TRANSACTION*+ 
RESETLOGS+ SPECIFIED+ 
REUSE+ SQL*+ USING*+ 
ROLLBACK*+ SQLCODE*+ 

SQLERROR*+ WRITE*+ 
SAVEPOINT+ STATEMENT+ WORK*+ 
SCHEMA*+ STORAGE+ 
SECTION*+ SWITCH+ 
SEGMENT+ SYSTEM*+ 


LEAS EAN EET A, 


ORACLE Terms 


Literals 


Variables 


The terms literal, constant, and value all have the same meaning within 
ORACLE; they all represent a specific piece of information. For 
example, ‘JACK’, "BLUE ISLAND”, and ‘101’ are all character jiterals. 
'01-JAN-89’ is a date literal. 5001 is a number literal. Notice that 
character and date literals are enclosed in single quotes. The quotes 
enable ORACLE to distinguish database objects name from character 
and date literals. 


A variable within ORACLE is used as a placeholder for a literal. 
ORACLE variables function in a similar manner as programming 
language variables. At any given moment, a variable may be empty or 
it may holda literal. Variables are used primarily in embedded SQL. 
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Datatypes 


Mixing Datatypes: 
Datatype Conversion 


Each literal or variable manipulated by the ORACLE RDBMS has a 
datatype. Datatypes associate a fixed set of properties with a value. 
These properties cause ORACLE to treat one datatype differently from 
another datatype. For example, addition may be performed on values 
of NUMBER datatype, but not on values of RAW datatype. 


Datatypes also restrict the range of values that data item may contain. 
For example, values of DATE datatype may not take on the value 
February 29 except on a leap year. Nor can a DATE datatype have the 
value 2 or ‘SHOE’. 


A value in the database assumes a datatype based on the datatype of 
the column to which it belongs. Datatypes are specified in the ALTER 
TABLE, CREATE CLUSTER, and CREATE TABLE statements. Each 
column of a table is assigned a datatype and consequently, each value 
belonging to a given column assumes that datatype. ORACLE assigns 
datatypes to non-database values based on the context of their use. For 
example, if you insert ’01-JAN-89 into a date column, ORACLE will 
treat the ‘01-JAN-89 character string as a value of DATE datatype after 
it has verified that it forms a valid date. 


Generally an expression may not mix datatypes. For example, an 
expression could not multiply 5 times 10 and then add ‘JAMES’. 


However, ORACLE will convert one datatype to another where it 
makes sense. For example, although the literal string ’10’ is of CHAR 
datatype, ORACLE can automatically convert the string ‘10’ to the 
NUMBER datatype if it is used in a numeric expression. 


ET 
The CHAR or VARCHAR Datatype 


The CHAR datatype is used to manipulate words and free-form text. It 
is less restrictive than all other datatypes and consequently has fewer 
properties than other datatypes. For example, all forms of text may be 
stored in the CHAR datatype, but only numbers may be stored in the 
NUMBER datatype. 


Data is stored in variable length strings of ASCII or EBCDIC values, 
depending on the character set of the host computer. The use of 
non-standard characters may reduce application portability across 
machine architectures. 
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Currently, the CHAR and VARCHAR datatypes are equivalent. These 
datatypes are used to store character (alphanumeric) data. You can use 
the words CHAR and VARCHAR interchangeably, with the same effect. 


The absolute maximum number of characters which can be stored in 
any column defined as CHAR or VARCHAR is 255. The maximum. 
length of a given CHAR or VARCHAR columzn is specified at table 
creation. You may change the maximum length of a column with the 
ALTER TABLE statement. 


Columns defined as CHAR or VARCHAR may appear in the Data 
Dictionary as VARCHAR. 


While CHAR and VARCHAR are treated equally in Version 6.0, itis 
expected that in a future version of ORACLE RDBMS, CHAR data will 
be fixed length, and VARCHAR will be of variable length. 


SEA 


Text 
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Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Specify a character string literal. 
none 


‘{echarj...’ 


char is a member of the character set (e.g. ASCII, 
EBCDIC) specified by the INIT.ORA parameter, 
LANGUAGE. 


A text literal may be a maximum of 255 characters. The text literal is 
enclosed in single quotes; a single quote is embedded by doubling it. 
Note: This Manual uses the terms text literal and character literal 
interchangeably. 

"Hello’ 

‘ORACLE.dbs’ 

"Jackie's raincoat’ 

"Happy Birthday, Tom!’ 

09-MAR-88’. 

The sections "Integer" and "Number" later in this chapter; the syntax 


descriptions of condition and expr in Chapter 4 "Operators and 
Functions" of this Manual. 
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NUMBER Datatype 


Using Scale and 
Precision 


Negative Scale 


The NUMBER datatype is used to store numbers (fixed or floating 
point). Numbers of virtually any magnitude may be stored, up to 38 
digits of precision. Numbers ranging from 1.0 x 10” to 9.99 x 10° 
can be stored. 


For numeric columns you can specify: 


* NUMBER 

* NUMBER with precision (total number of digits, precision may 
range from 1 to 38) 

* NUMBER with precision and scale (number of digits to right of 
decimal point, scale may range from -84 to 127) 


The syntax of a NUMBER datatype is: 

column_name NUMBER [{ ( precision [, scale 2) ] 
asin: 

CREATE TABLE MINI (WEENUMBERS NUMBER (2,1)) 


When specifying numeric fields, it is a good idea to specify the 
maximum number of digits and decimal places. This provides extra 
integrity checking on input. The specification of the maximum digits to 
be stored within a column does not force all values to be fixed length. 
If a value exceeds maximum precision, an error will be returned. If a 
value exceeds the maximum scale, it will be rounded. The following 
table shows examples of how data would be stored using different 
scale factors. 


Actual Data Specified as Stored as 
7,A56,123.89 NUMBER 7456123.89 
7A456,123.89 NUMBER (9) 7456124 
7,A56,123.89 NUMBER (9,2) 7456123.89 
7,456,123.89 NUMBER (9,1) 7456123.9 
7,456,123.8 NUMBER (6) exceeds precision 
7A56,123.8 NUMBER (15,1) 7456123.8 
7,456,123,89 NUMBER (7,-2) 7456100 
7,A56,123.89 NUMBER(7,2) exceeds precision 


If the scale is negative, the actual data is rounded to the specified 
number of places to the left of the decimal point. For example, a 
specification of (10,-2) means to round to hundreds. 
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Scale Greater than 
Precision 


Exponential 
Representation 


FLOAT Subset 


Although infrequently used, it is valid to specify a scale that is greater 
than precision. If so, then precision specifies the maximum valid digits 
after the decimal point. As with all NUMBERs;, an error will be 
returned if the value exceeds the maximum precision and the value 
will be rounded if it exceeds the maximum scale. For example, a 
column defined as NUMBER(4,5) would require a zero for the first 
digit after the decimal point, and would round all values pass the fifth 
digit after the decimal point. 


The following table reveals the effects of a scale greater than precision. 





Actual Data Specified As Stored As 
01234 NUMBER(4,5) 01234 
00012 NUMBER(4,5) 00012 
000127 NUMBER(4,5) 00013 
0000012 NUMBER(2,7) 0000012 
00000123 NUMBER(2,7) 0000012 


Numbers may also be represented in exponential format. An 
exponential number is a number followed by E, a sign and a digit from 
1 to 128. For example, 123456 is represented by 1.23456E+5, and 0.0987 
is represented by 9.87E-2. For a precise definition of the exponential 
format of ORACLE numbers, refer to the section "Number" later in this 
chapter. 


ORACLE supports the concept of a floating point number with the 
FLOAT datatype. This datatype conforms to the ANSI standard for 
floating point numbers. A value of FLOAT datatype can specify the 
decimal point anywhere from the first to the last digit (or not at all). 
SCALE is not applicable to FLOAT since there is no restriction on how 
many digits after the decimal point you may specify (up to the 
maximum precision). 


FLOAT may be defined as FLOAT, FLOAT(*), or 
FLOAT(binary_precision). FLOAT and FLOAT(*) are equivalent and 
represent the maximum precision of 126 binary digits. 126 binary 
digits is roughly equivalent to 37 digits of decimal precision. 


You may specify the maximum precision for a floating point number 
column with the FLOAT(binary_precision) syntax. To convert from 
binary precision to decimal, multiply the binary value by 0.30103. To 
convert from decimal precision to binary, multiply the decimal value 
by 3.32193. 
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Other Forms of 
NUMBERs 


For compatibility with other database systems, ORACLE supports the 
syntax of a wide variety of numeric datatypes including DECIMAL, 
INTEGER, REAL, and DOUBLE_PRECISION. All forms of number 
datatypes are actually stored in the same internal ORACLE number 
format. The additional forms of the number datatype are variations of 
precision and scale. For example, DECIMAL() implies a scale of 0. 
For a detailed list of the forms of numeric datatypes that ORACLE 


supports, refer to the section "Numeric Datatype Summary" later in this 


chapter. 


Be NUS IT 


Integer 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Specify an amount using a whole number (an integer), For example, 
the integer might represent the size of a database. 


None. 


C+] Jdigit [digit]... [KIM] 
digit is one of 0,1,2,3,4,5,6,7,8,9. 


If integer is followed by K, then the actual amount is computed as the 
integer multiplied by 1024, If M is used, then the amount will be the 

integer multiplied by 1048576, Generally, integer represents bytes. K 
represents kilobytes and M represents megabytes. However, you can 
use the K and M notation anywhere an integer expression is allowed. 


An integer may store a maximum of 38 digits of precision. 


6M 


The sections "Text" and "Number" in this chapter; the syntax 
descriptions of condition and expr in Chapter 4 "Operators and 
Functions" of this Manual. 
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Number 
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Purpose Represent a numeric literal. 
Prerequisites None. 


Syntax digit (digit...].[digit.- -] {exponent | multiplier}] 


Keywords and digit is one of 0,1,2,3,4,5,6,7,8 or 9. 
Parameters exponent is (el E)L+| -Idigitldigit]... 
multiplier is either K or M. The multiplier causes the number 
to be multiplied by 1024 or 1048576 for K or M 
respectively. 


Usage Notes May be used to represent integers or real numbers. The exponent 
notation is incompatible with the multiplier notation. 


The multiplier notation may only be used to represent integers. 


A number may store a maximum of 38 digits of precision 


Examples 25 
6.34 
0.5 
TE2 
25e-03 
256K 
4M 


Related Topic The sections "Text" and "Integer" in this chapter; the syntax description 
of expr in Chapter 4 "Operators and Functions" of this Manual. 
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DATE Datatype 


Date Arithmetic 


The DATE datatype is used to store date and time information. 
Although date and time information can be represented in both CHAR 
and NUMBER datatypes, ORACLE associates special properties with 
date values. 


For each date value the following information is stored: 


* Century 

° Year 

* Month 

+ Day 

* Hour 

* Minute 

* Second. 
Time data is stored in 24-hour format. By default, the time ina DATE 
field is 12:00:00 a.m. (midnight) if no time portion is specified. The 
default date for a DATE field is the first day of the current month. The 
function SYSDATE returns the current date and the current time. 


Standard ORACLE DATE formatis DD-MON-YY, as in 13-NOV-88. To 
enter dates which are not in standard ORACLE date format, use the 
TO_DATE function with a format mask. 


To enter the time portion of a date, the TO_DATE function must be 
used with a format mask indicating the time portion, as in: 
INSERT INTO BIRTHDAYS (BNAME, BDAY) 
VALUES (‘ ANNIE’, 
TO_DATE (’13-NOV-85 10:56 A.M.’, ’DD-MON-YY HH:MZ A.M.) 
To compare dates which have time data, you can use the SQL function 
TRUNC to ignore the time component. 


While you cannot multiply and divide dates from one another, you can 
add and subtract number constants as well as other dates from dates, 
For example, SYSDATE + 1 is tomorrow, and SYSDATE - 7 is one week 
ago. Subtracting SYSDATE from the HIREDATE column of the EMP 
table returns the number of days since each employee was hired. 
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Using Julian Dates 


ORACLE provides functions for many of the common date operations. 
For example, the ADD_MONTHS function allows you to add or 
subtract months from a date. The MONTHS_BETWEEN function 
returns the number of months between two dates. The fractional 
portion of the result represents that portion of a 31-day month. For 
more information on date functions, refer to Chapter 4 “Operators and 
Functions" of this Manual. 


Because each date contains a time component, most results of date 


operations include a fraction. This fraction means a portion of one day. 


For example, 1.5 days is 36 hours. 


A Julian date is the number of days since Jan 1,4712 BC. Julian dates 
allow continuous dating from a common reference. ORACLE 
implementation of a Julian date has no time component. The format 
mask "J" can be used with date functions (TO_DATE or TO_CHAR) to 
convert date data into Julian dates. For example: 


SELECT TO_CHAR(TO_DATE (’01-JAN-89’),‘J‘) FROM DUAL 
returns: 
2447528 


Dray To Nu 


LONG Datatype 


Restrictions on LONG 
Data 


Columns defined as LONG can store variable length character strings 
containing up to 65,535 characters. LONG data is the same as 
VARCHAR except that it stores larger values. LONG data can be used 
to store arrays of characters, or even a short document. 


LONG columns are used in the Data Dictionary to store the text of 
view definitions. You can use LONG columns in: 

+ SELECT lists - 

+ SET clauses of UPDATE statements 

« INSERT statements 


LONG datatypes are subject to some restrictions. Only one LONG 
column is allowed per table. Also, you cannot use LONG columns in: 
+ indexes 


+ WHERE, GROUP BY, ORDER BY, CONNECT BY, or 
DISTINCT clauses 


+ functions (such as SUBSTR or INSTR) 
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expressions 

* the SELECT list of a query block connected with another query 
block by UNION, INTERSECT, or MINUS 

+ distributed queries (although they can be used in the SQL*Plus 

COPY command) 


Pia reise ci ies ae ena AT 
RAW and LONG RAW Datatypes 


The RAW and LONG RAW datatypes are used for byte-oriented data 
(binary data or byte strings, for example) to store character strings and 
graphics character sequences, ORACLE displays RAW datatype values 
as hexadecimal character values. RAW data is equivalent to CHAR 
(and LONG RAW to LONG) except when transmitted by SQL*Net, at 
which time SQL*Net will convert between ASCH and EBCDIC 
character set representations for CHAR data. 


You must enter RAW data as hexadecimal character strings. 


ESET 
DB2 and SQL/DS Datatypes 


In addition to ORACLE datatypes, the SQL statements that create tables 
and clusters will accept datatypes from IBM's products SQL/DS and 
DB2, and internally convert them to ORACLE datatypes as follows: 





SQL/DS or DB2 Datatype ORACLE Datatype 
SMALLINT NUMBERG38) 
INTEGER NUMBER(38) 
DECIMAL(m,n) NUMBER(m,n) 
FLOAT NUMBER 
VARCHAR(n) CHAR(n) 

LONG VARCHAR LONG 


Because they have no corresponding ORACLE datatype, these SQL/DS 
datatypes should never be used: 


+ GRAPHIC, 
* VARGRAPHIC 
* LONG VARGRAPHIC 


However, since all SQL/DS datatypes are reserved words, they cannot 
be used to name database objects such as tables or indexes, 
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Piser e aOSE  S 


The ROWID Datatype 


Why Use ROWIDs? 


Associated with every row in the database is a pseudo-column that 
corresponds to the address of that row. That address can be retrieved 
with a SQL query using the reserved word ROWID. As the following 
example shows, a query selecting ROWID will return a result with a 


hexadecimal string representation of the address for each row selected: 


SELECT ROWID, ENAME FROM EMP WHERE DEPTNO = 20 


ooo0000Fr.6000.0002 SMITH 
0000000F.0003.0002 JONES 
0000000F.0007.0002 scoTT 
0000000F.000A.0002 ADAMS 
0000000F.000C.0002 FORD 


ROWID returns three pieces of information necessary to locate a row: 


« which block in the database file 
+» which row in the block (first row is 0) 
+ which database file it is in (first file is 1) 


ROWIDs have several important uses: 


+ They are the fastest means of accessing any particular row. 
+ They can be used to see how a table’s rows are stored. 
+ They are unique identifiers for rows ina given table. 


Arow’s ROWID remains constant during the lifetime of the row. 
However, you should not treat ROWID as a table’s primary key. A 
row’s ROWID can change if you delete it and réinsert it, for example, 
with the Import and Export utilities. Also, if you delete a row, 


ORACLE may reassign its ROWID to a new row that you insert later. 


Although ROWIDs can be used in the SELECT and WHERE clauses of 
a query, they are not stored in the database and consequently are not 
updatable data. It is not possible to UPDATE, INSERT, or DELETE a 
ROWID value. 
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Datatype Conversion 


FIGURE 3-1 
Datatype Conversion Functions 


WHERE clauses and expressions (boolean, arithmetic, or string) may 
reference different datatypes in their comparisons. In these cases, 
ORACLE can often use data conversion to resolve the statement. In the 
following examples, ORACLE automatically performs the necessary 
data conversions: 

SELECT ENAME PROM EMP WHERE ENAME = 135 

SELECT ENAME FROM EMP WHERE EMPNO = '7936¢ 

SELECT ENAME FROM EMP WHERE HIREDATE = ’12-MAR-86! 

SELECT ENAME FROM EMP WHERE ROWID = ’00002514.0001.0001' 


To perform the conversion, ORACLE can: 
* convert the constant to the column’s defined datatype 
* convert the column’s value to the datatype of the constant 
* convert one column’s datatype to another column’s datatype 


Figure 3-1 shows three common user functions which can convert a 


value from one datatype to another: 


To 
From CHAR NUMBER DATE 





CHAR unnecessary | TO NUMBER TO_DATE 


a a i-,, 


NUMBER TO_CHAR unnecessary TO_DATE 





DATE TO_CHAR invalid unnecessary 
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Datatype 
Comparison Rules 


Number Values 


Date Values 


Char Values 


e 


Data conversion is context-dependent. Do not expect the same sort of 


- conversion to work in every case. Rather than rely on implied or 


automatic conversions, you should specify explicit conversions using the 
preceding SQL functions for the following reasons: 


+ SQL statements are easier to understand when you use explicit 
datatype conversions functions. 


+ Automatic datatype conversion can have a negative impact 
performance, particularly if a column’s datatype is converted 
to that of a constant rather than the other way around. 


+ Algorithms for implicit conversion are subject to change across 
software releases and among ORACLE products and thus 
behavior of explicit conversions is more predictable. 


The following is a list of the comparison rules for different types of data 
values: 


A larger value is considered "greater" than a smaller one. All negative 
numbers are "smaller" than all positive numbers. Thus, -1 is smaller 
than 100; -100 is smaller than -1. 


A later date is considered "greater" than an earlier one. For example, 
'299-MAR-88’ is "smaller" than ‘05-JAN-89’, and 1:35pm’ is "greater" 
than 10:09am’. 


Values are compared character by character up to the first character 
that differs. Whichever value has the greater character in that position 
is considered greater. If two char values are the same up to the end of 
the shorter one, the longer value is considered greater. 


Characters are compared according to the host computer's collating 
sequence. One character is greater than another if it appears after the 
other in the collating sequence. 


Most computers use one of two collating sequences, called ASCII 
(American Standard Code for Information Interchange) and EBCDIC 
(Extended Binary Coded Decimal Interchange Code). These collating 
sequences are presented in the following pages. 


Note: ORACLE uses the collating sequence of the host computer. 
Upper- and lowercase letters are not equivalent. In ASCII, all 
lowercase letters are greater than all uppercase letters. In EBCDIC, the 
reverse is true. 


In ASCII, the character literals ’0’ through ’9” sort below the alphabet; 
Jn EBCDIC, the reverse is true. 
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ASCII Collating 
Sequence 


The following two tables list the collating sequences for both ASCII and 


EBCDIC. 


The following table lists the ASCII collating sequence: 















































Decimal Decimal 

value Symbol value Symbol 
32 blank 59 7 

33 ! 60 < 

34 y 61 

35 # 62 > 

36 $ 63 ? 

37 % 64 @ 

38 & 65-90 A-Z 
39 91 [ 

40 ( 92 \ 

41 ) 93 ] 

42 bd 94 A 

43 + 95 fe 

44 ; 96 i 

45 - 97-122 a-Z 
46 123 { 
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EBCDIC Collating The following table lists the EBCDIC collating sequence: 
Sequence 





















































Decimal Decimal 

value Symbol value Symbol 
64 blank 108 % 
74, ¢ 109 

75 E 110 

76 < 111 2 

77 ( 122 : 

78 + 123 # 

79 | 124 @ 

80 & 125 i 

90 ! 126 = 

91 $ 127 * 

92 * 129-137 a-i 
93 ) 145-153 j-r 
94 . 162-169 S-Z 
95 = 193-201 A-I 
96 - 209-217 J-R 
97 / 226-233 S-Z 
107 f 240-249 0-9 
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Pe SS ET CLT 


Datatype Summary 


When you create a table, you must specify the type of data that may 
appear in each column. SQL recognizes the datatypes in the following 
table. If you enter an invalid value, SQL issues an error message and 
performs a ROLLBACK of that statement. 


The following list summarizes ORACLE datatypes. Refer to the 
previous sections for a complete description of each datatype. 


Datatype 


Description 





CHARGize) 


CHARACTER 
VARCHARGize) 


DATE 


LONG 


LONG VARCHAR 
RAW(size) 


LONG RAW 


ROWID 


Variable length character data, size 
characters long. Maximum size is 255. The 
default size is 1. 


Same as CHAR. 


Same as CHAR, but you must specify size. 
Future versions of ORACLE may define 
CHAR as fixed length and VARCHAR as 
variable length. 


Valid dates range from January 1, 4712 BC 
to December 31, 4712 AD. Default format is 
DD-MON-YY as in ’01-JAN-89’, 

Character data of variable length up to 
65,535 characters. You can only define one 
LONG column per table. 


Same as LONG, 


Raw binary data, size bytes long. You must 
specify size. Maximum size is 255 bytes. 
Values must be inserted as character strings 
in hexadecimal notation. 


Raw binary data; otherwise the same as 
LONG. Values entered into columns of type 
LONG RAW must be inserted as character 
strings in hexadecimal notation. 

A value that uniquely identifies a row ina 
table. ROWID values are returned by the 
pseudo-column ROWID, and may be 
converted to the CHAR datatype with the 
ROWIDTOCHAR function. You cannot 
create table columns of this type. 
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Numeric Datatype 





Summary 
If you specify Itis stored as... 
Type Precision Scale 
NUMBER NUMBER 38 null 
NUMBER (*) NUMBER 38 null 
NUMBER (*, 5) NUMBER 38 5 
NUMBER (p) NUMBER Pp ie) 
NUMBER (p, 5) NUMBER p Ss 
DECIMAL NUMBER 38 0 
DECIMAL (*) NUMBER 38 0 
DECIMAL (*, 5) NUMBER 38 s 
DECIMAL (p) NUMBER Pp 0 
DECIMAL (p, 5) NUMBER p Ss 
INTEGER NUMBER 38 0 
SMALLINT NUMBER 38 Q 
FLOAT NUMBER 38 null 
FLOAT (*) NUMBER 38 null 
FLOAT (b) NUMBER b null 
REAL NUMBER 63 null 


pinary (18 decimal) 


DOUBLE PRECISION NUMBER 38 null 


The range of p (decimal precision) is 1 to 38. The range of s (scale) is -84 
to 127. The range of b (binary precision) is 1 to 126. 


DEC and NUMERIC are synonyms for DECIMAL. INT isa synonym 
for INTEGER. 


Null scale implies floating point and non-null scale implies fixed point. 


For a complete definition of the interaction between precision and 
scale, refer to the section "NUMBER Datatype” earlier in this chapter. 
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Null Values 


If a row lacks a data value for a particular column, that value is said to 
be null. Columns of any datatype may contain null values unless the 
column was defined as NOT NULL when the table was created. 


A null value: 


* is appropriate when the actual value is unknown, or when a 
value would not be meaningful 

* is not equivalent to a value of zero 

* will evaluate to null in any expression. For example, NULL 
multiplied by 10 is NULL. 


You can use the NVL function to temporarily convert a null value to an 
actual value. For example, NVL(COMM,0) either returns 0 if COMM is 
null or the value of COMM if COMM is not null. 


Most group functions ignore null values, For example, in a query that 
averages the five values 1000, NULL, NULL, NULL, and 2000 for 
COMM, will return 1500, because (1000+2000)/2 = 1500. 


The only comparison operators you should use with null values are IS 
NULL and IS NOT NULL. If you use any other operator with a null 
value, the result is always unknown. Since a NULL represents a lack of 
data, a null value cannot be either equal or unequal to any other value, 
even another NULL. 


ORACLE treats conditions evaluating to unknown values as FALSE. 
For example, since the condition COMM = NULL is always unknown, 
a SELECT statement with this condition in its WHERE clause returns 
no rows. Note that ORACLE returns no error message in this situation. 


The following table summarizes results of comparisons using null 
values: 


If Ais: Comparison Result 

10 AIS NULL FALSE 

10 AISNOTNULL TRUE 
NULL AISNULL TRUE 
NULL AISNOTNULL FALSE 

10 A=NULL Unknown 
10 A!l= NULL Unknown 
NULL A=NULL Unknown 
NULL Al= NULL Unknown 
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Pseudo-columns 
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A pseudo-column behaves like a column of a table, but is not actually 
stored in the table. While queries may reference pseudo-columns, 
pseudo-columns may not be inserted, deleted, or updated. 


The following table lists SQL pseudo-columns: 


Pseudo-column 


Value Returned 





sequence_name. 
CURRVAL 


sequence_name. 
NEXTVAL 


ROWID 


ROWNUM 


SQL Language Reference Manual 


Returns the current value in the specified 
sequence. A sequence_name must be specified. 


Returns the next value in the specified 
sequence. A sequence_name must be specified. 


For a complete description of sequences, 
refer to the CREATE SEQUENCE statement 
in Chapter 5 “SQL Statement Reference" of 
this Manual. 

Returns a row’s ROWID. For information 
on ROWID, refer to the section "The 
ROWID Datatype” earlier in this chapter. 
Returns a number indicating the sequence 
in which a row was selected from a table or 
set of joined rows. The first row selected has 
a ROWNUM of 1, the second has 2, etc. 
ROWNUM is chiefly useful for limiting the 
number of rows returned by a query (e.g,, 
WHERE ROWNUM<10). It may also be 
used to assign unique values to each row of 
a table (e.g., UPDATE table SET column = 
ROWNUM). ROWNUM is assigned as the 
row is retrieved and not affected by any 
order imposed by the ORDER BY clause 
(that is, the ROWNUM is assigned before 
the rows are ordered). 





LEVEL 


FIGURE 3-2 
Hierarchical Tree 





root’ 
parent 


Note that WHERE ROWNUM > any positive 
number will never return any rows. This 
occurs because ROWNUM is assigned on 
order of display. For example, the first row 
to be displayed is assigned a ROWNUM of 1 
and fails the WHERE ROWNUM > 1 test. 
The second row to be returned will now be 
the first row displayed and is also assigned a 
ROWNIUM of 1 and fails the WHERE 
ROWNUM > 1 test. All rows would fail to 
satisfy the WHERE ROWNUM > 1 test, and 
consequently, no rows are returned. 


Used in the CONNECT BY clause of the 
SELECT statement; returns 1 for a root node, 
2 for a child of a root, etc. A root node is 
defined as the highest node within an 
inverted tree. A child is any non-root node. 
A parent is any row that has children. A leaf 
is any row without children. For an 
example of an inverted tree, refer to Figure 
3-2. For usage notes on LEVEL, refer to the 
section "CONNECT BY and START WITH 
Clauses" in Chapter 6 "SELECT Statement 
Clauses" of this Manual. 










Level 1 
Level 2 
| child’ | 
| leaf | Level 3 
| chiar li chiar | chia | 
leaf wa leah: = af _ "Level 4 
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CHAPTER 


OPERATORS AND 
FUNCTIONS 


: | "his chapter describes methods of manipulating individual data 
items. For example, standard arithmetic operators such as addition 

and subtraction are discussed as well as less common functions such as 
absolute value or string length. Topics include: 

* operators 

* functions 

* format models 

* expressions 

* conditions 
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Operators 


Arithmetic Operators 


Operators and functions perform similar tasks. Both accept zero or more 
arguments and both return one or more results. Both are used to 
manipulate individual data items. 


Operators differ from functions in that they are represented by special 
characters whereas functions follow the format: 


function_name(argumenti, argument2, ...) 


Most operators accept at most 2 arguments; the structure of functions 
permits some functions to accept 3 or more arguments. 


In each table, operators are listed in descending order of precedence. In 
this discussion, precedence is the order in which operators are 
evaluated. For example, in the expression, 1+2*3, first 2 is multiplied 
by 3 (resulting in 6) and then the result is added to 1 (resulting in 7) 
because multiplication is evaluated before addition. Depending on the 
order of evaluation (i.e. the precedence), the answer could be 8 or 9. 
Operators with equal precedence are grouped together with broken 
lines. 


Arithmetic operators are used in expressions to negate, add, subtract, 
multiply, and divide numeric values. The result of the operation is 
also a numeric value. Some of these operators are also used in date 
arithmetic. The following table lists arithmetic operators in order of 
precedence from high to low: 





Operator Function Example 
QO Overrides normal operator — SELECT (X+¥)/(X-Y)... 
precedencerules. Operators 
within parentheses are 
evaluated before those outside 
the parentheses. 
+ Denote a positive or negative _.. WHERE QTYSOLD =-1 
expression. .. WHERE -SAL <0 
*/ Multiply, divide. SELECT 2*X+1 
«WHERE X>Y/2 
+ Add, subtract. SELECT 2°X+1 
.- WHERE X>Y-Z 
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Character Operators 


Comparison Operators 


Character operators are used in expressions to manipulate character 
strings. The following table lists the one current character datatype 


operator: 


Operator 


Function 


Example 





Char value concatenation. 


SELECT NAME IS’ | | ENAME... 


The result of the concatenation is a character value. Character strings 

of CHAR datatype may be a maximum of 255 characters. This 
restriction also applies to character strings generated by character string 
concatenation. 


Comparison operators are used in conditions that compare one 
expression to another. As with all conditions, the result of comparing 
one expression to another is TRUE or FALSE (Refer to the section 
"Conditions" later in this chapter), The following table lists SQL 





comparison operators: 
Operator Function Example 
QO Overrides normal operator —_.. NOT (A=1 OR B=) 
precedence rules. 
= Test for equality. «WHERE SAL=10000 
In, A=, Test for inequality. . WHERE SAL!=10000 
or <> 
> "Greater than" & WHERE SAL>10000 
< “less than" tests 
>= "Greater than or equal to" & — .. WHERE SAL>=10000 
<= "less than or equal to" tests. 
IN "Equal to any member of" ..WHERE JOB IN 
(CLERK’,/ANALYST’) 
Equivalent to "= ANY". «WHERE SAL IN 
(SELECT SAL FROM EMP 
WHERE DEPTNO=30) 
NOTIN Equivalent to "!= ALL". «WHERE SAL NOT IN 
Evaluates to FALSE if any (SELECT SAL FROM EMP 
member of the set is NULL. WHERE DEPTNO=30) 
ANY Compares a value to each WHERE SAL = ANY 
value returned by a list or (SELECT SAL FROM EMP 
subquery. Must be prefaced = WHERE DEPTNO=30) 
with one of: =, !=, >, <, <= ,>=, 
ALL Compares a value toevery —.. WHERE (SAL,COMM) >= ALL 


value returned by a list or 
subquery. Must be prefaced 
with =, [=, >, <, <=, >=, 


((1400,300), (3000,0) ) 
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NOT IN Operator 


Operator Function Example 





{NOT] [Not] greater than or equal to WHERE A BETWEEN 1 

BETWEEN* x and less thanorequaltoy. AND9 

ANDy 

{NOT] TRUE if asubquery returns © WHERE EXISTS 

EXISTS [does not return] at least one (SELECT SAL FROM EMP 
row. WHERE DEPTNO=30) 

[NOT] "does not match/matches the WHERESTATE LIKE ’T%’ 

LIKE following pattern." The 


character "%" is used to match 
any string of zero or more 
characters except a NULL 
string; and the character me 
matches any single character. 
For examples, refer to the 
section "LIKE Operator" later 


in this chapter. 
IS [NOT] "Ts [not] null." IS (rather than WHERE JOB IS NULL 
NULL "=") must be used when 


testing for NULL. Fora 
discussion of NULL, refer to 
Chapter 3 "Elements of the 
SQL Language.” 


All rows will evaluate to false (and no rows will be returned) if any 


member of the list of values referenced by a NOT IN operation is null. 


For example: 


SELECT ' TRUE! 
FROM EMP 
WHERE DEPTNO NOT IN (5,15,nul1) 


will return no rows, whereas: 


SELECT ‘TRUE’ 
FROM EMP 
WHERE DEPTNO NOT IN (5,15) 


will return ’TRUE’. The first example returns no rows because: 
DEPINO NOT IN (5,15,null) 

evaluates to: 

DEPTNO != 5 AND DEPTNO != 15 AND DEPTNO != null 


Because all conditions that compare a null result in null, the entire 
expression results in a null. This behavior can easily be overlooked, 
especially when the NOT IN operator references a subquery. 
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Logical Operators 


FIGURE 4-1 
Truth table: AND 


Logical operators are used to affect the result of multiple conditions. The 
AND operator requires that the row satisfy both conditions. The OR 
operator requires that the row satisfy either condition. For example, in 
the WHERE clause of the following SELECT statement, the AND 
logical operator is used to ensure that only those hired before 1984 and 
also earning more than $1000 a month will be displayed: 


SELECT * FROM EMP 
WHERE (HIREDATE < ‘01-JAN-84’) AND (SAL > 1000) 


The following table lists SQL logical operators in order of precedence 
from high to low: 





Operator Function Example 
Q Overrides normal operator — SELECT... WHEREx=yand (a= b 
precedence rules. orp=q) 
NOT Reverses the result of a .« WHERE NOT (JOB IS NULL) 
logical expression. .. WHERE NOT (CODE LIKE ‘T%') 
»s WHERE NOT (SAL BETWEEN 
500 AND 999) 
«WHERE NOT (A=1) 
AND Sets logical expression tobe —_.. WHERE A=1 AND B=1 
TRUE if both conditions are 
TRUE. 
OR Sets logical expression to be —_.. WHERE A=1 OR B=1 


TRUE if either condition is 
TRUE. 


Figure 4-1 illustrates the results of comparing 2 conditions with the 
AND operator. 














AND true false null 
true true false null 
false false false false 
null null false null 
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FIGURE 4-2 
Truth Table: OR 


Figure 4-2 illustrates the results of comparing two conditions with the 
OR operator. 





























Set Operators Set operators combine the results of multiple queries into a single result. 
The following table lists SQL set operators in order of precedence from 
high to low: 

Operator Function Example 
UNION Combines queries to return _...SELECT... 
all distinct rows returned by UNION SELECT... ; 
any individual query. 
INTERSECT Combines queries to return ..SELECT... 
all distinct rows returned by INTERSECT SELECT... ; 
every individual query. 
MINUS Combines queries to return _...SELECT... 
all distinct rows returned by MINUS SELECT... 
the first query but not the 
second. 
Note: When duplicate records exist in tables, only one record per set of 
duplicates is displayed in the result when using INTERSECT, MINUS, 
and UNION. 
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FIGURE 4-3 
Set Operators 


Figure 4-3 shows a graphical representation of the effects of the various 
set operators. The shaded portions indicate the result returned by 
ORACLE. 





SET OPERATORS 
A B 
SELECT * 
FROM A 
UNION 
SELECT * 
FROM B 
A B A B 
SELECT * SELECT * 
FROM A FROM A 
MINUS INTERSECT 
SELECT * § SELECT * 
FROM 8 FROM B 
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Other Operators 
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Operator 


The following table lists other SQL operators: 


Function Example 





) 


[table.]* 


Indicates that the preceding © WHERE DEPT.DEPTNO= 
column is the outer join EMP.DEPTNO (+) 
column in a join. 

Selects all the columns from SELECT * FROM EMP 
the tables in a query. When 
prefaced by the table name 
and a period, the query 
selects all columns in that 
table. 


SELECT EMP.* FROM EMP 


COUNT(expr) Returns the number of rows — SELECT COUNT(COMM) 


COUNT(*) 


ALL 


DISTINCT 


PRIOR 


SQL Language Reference Manual 


where expr is not null. FROM EMP 


Returns the number of rows in SELECT COUNT(*) 
the table, including those with FROM EMP 
nulls. 


Retains duplicate valuesin | SELECT ALL*... 
queries and aggregations .««COUNT(ALL DEPTNO) 
(ALL is the default as 

compared to DISTINCT). 

Eliminates duplicate rows SELECT DISTINCT *... 


from the result ofa query or — ..COUNT(DISTINCT 


eliminates duplicate values DEPTNO)... 
from an aggregate expression. 
Defines the parent-child CONNECT BY 


relationship in a tree- PRIOR EMPNO = MGR 
structured query. The 
expression on the left side of 
the condition (EMPNO) 
represents the parent row; the 
expression on the right side 
(MGR) represents the child 
row. May be used in any 
clause of a tree structured 
query, not just in CONNECT 
BY. 


LIKE Operator 


Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Used in character string comparisons with pattern matching. 
None. 


SELECT .... 
WHERE char LIKE pattern 


char is a expression of datatype CHAR. Character 
string literals must be enclosed in single quotes. 
Refer to the syntax descriptions for expr later in this 
chapter and text in Chapter 3 "Elements of the SQL 
Language” of this Manual. 


pattern is an expression of datatype CHAR that uses the 
special pattern matching characters % and _. 


While you use the = operator to exactly match one character string to 
another, you use the LIKE operator to match a portion of one character 
string to another. 


Ina LIKE clause, you must compare the column to a pattern rather than 
to.aconstant. You must specify the column before the LIKE keyword. 
For example, you must enter this query: 

SELECT SAL 


FROM EMP 
WHERE ENAME LIKE ’BL%! 


rather than either of these queries: 


SELECT SAL 
FROM EMP 
WHERE ENAME = /BL8’ 


SELECT SAL 
FROM EMP 
WHERE /BL%’ LIKE ENAME. 
A CHAR pattern may include two special characters that can match 
different characters in the data value. An underscore "_" is used to match 
exactly one character. A percent sign "%" is used to match zero or more 
characters. Note, however, that the string ’%’ cannot match a NULL. 


Case is significant in all conditions comparing character expressions 
including the LIKE and = operators. You can use the UPPER() function 
to do a case insensitive match as in: 


UPPER (ENAME) LIKE UPPER({’ sm%’ ) 
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Examples 


Related Topics 


LIKE may be used in any logical expression involving CHAR datatype 
values. 


When LIKE is used to search an indexed column for a pattern, the 
speed advantage of indexing is lost if the first character in the pattern is 
"%" or"_". If the leading character in the pattern is not "%" or "_", most 
of the speed advantage of indexing is realized, since ORACLE can 
restrict the comparison to rows known to begin with the specified first 


character. 


You can search for the % or _ character with the TRANSLATE function. 


For example, to search for any employees with an underscore in their 
name, enter: 


SELECT ENAME 
FROM EMP . 
WHERE TRANSLATE (ENAME,’_',/#’) LIKE '%#%’ 


The preceding example used the TRANSLATE function to convert _ to 
# for the purpose of evaluating the query. It will also return those 
employees who have a # in their name. 


The condition: 


ENAME LIKE ’BL%’ 


translates to, "Return TRUE if the ENAME value begins with BL and is 
followed by zero or more characters". All the following values would 
make the preceding condition TRUE: 


BLAKE, BL, BLACK, BLUE 

Case is significant so bl or Bl would evaluate to FALSE. 
The condition: 

ENAME LIKE ’ SMITH_! 

is true for the values: 


* SMITHE 
© SMITHY 
* SMITHS 


but not for SMITH, since the special character "_" must match exactly 
one character in the comparand. 


The section "Comparison Operators" and the syntax description of expr 
in this chapter, the SELECT statement in Chapter 5 "SQL Statement 
Reference", and the WHERE clause in Chapter 6 "SELECT Statement 
Clauses" of this Manual. 
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Functions 


Functions behave similar to operators. Both accept zero or more 
arguments and both return one or more results. Both are used to 
manipulate individual data items. 


Operators differ from functions in that they follow the format of 
argument! operator argument2, whereas functions follow the format of 
function_name (argument1, argument2,...). An argument is a user-supplied 
variable or constant. 


Most operators accept at most two arguments; the structure of 
functions permit functions to accept three or more arguments. 


All single row functions have the following attributes: 


+ Single row functions return one result per row. 
* Single row functions expect zero or more user arguments, 
* Single row functions may be nested. 


* Single row functions can be used anywhere that user variables, 
columns, or expressions of the same type can be used. 


* Single row functions act on each row returned in the query 
without respect to any other row that is returned by the query. 


Arguments are abbreviated in the following manner: 





Argument Argument 

Abbreviation Explanation 

char Character constant in single quotes or 
expression of datatype C AR. 

dore Date constant or expression of datatype DATE. 

morn Any number constant or expression of 
datatype NUMBER. 

raw Expression of datatype RAW. 

xowid Expression of datatype ROWID. 

* Datatype depends on the context of the function. 

expr Any expression of any datatype. 
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Single Row 
Number Functions 


ABS 


CEIL 


FLOOR 


MOD 


Numeric functions accept numeric input and return numeric values. 
The following table lists the SQL number functions: 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 
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ABS (xn) 
Returns the absolute value of n. 


SELECT ABS(-15) "Absolute™" FROM DUAL 


CEIL (n) 
Returns smallest integer greater than or equal to n. 
SELECT CEIL(15.7) "Ceiling" FROM DUAL 


Ceiling 


FLOOR (n) 
Returns largest integer equal to or less than 7. 
SELECT FLOOR(15.7) "Floor" FROM DUAL 


MOD (m, n) 


Returns remainder of m divided by n. 
If nis 0, mis returned. 


SELECT MOD(7,5) "Modula" FROM DUAL 





| 
| 
| 
| 
| 
| 





POWER 


ROUND 


SIGN 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


POWER (m,n) 


Returns m raised to the nth power. n must be an 
integer; if not, an error will be returned. 


SELECT POWER(3,2) "Raised" FROM DUAL 


ROUND (n{,m]) 


Returns n rounded to m places right of the decimal 

point; if m is omitted, to 0 places. m can be negative 
to round off digits left of the decimal point. m must 
be an integer. 


SELECT ROUND (15.193,1) "Round" FROM DUAL 


SELECT ROUND(15.193,-1) "Round" FROM DUAL 


Round 


20 


SIGN (n) 


If n<0, the function returns -1; if n=0, the function 
returns 0; if n>0, the function returns 1. 


SELECT SIGN(-15) "Sign" FROM DUAL 


Sign 


-1 
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SQRT Syntax 


SORT (n) 


Purpose Returns square root of n; if n<0, NULL. SQRT 
returns a “real” result. 
Example SELECT SQRT(25) "Square root" FROM DUAL 
Square root 
5 
TRUNC Syntax TRUNC (n[,m]) 
Purpose Returns 7 truncated to m decimal places; if m is 
omitted, to 0 places. m can be negative to truncate 
{make zero) m digits left of the decimal point. 
Example SELECT TRUNC(15.79,1) "Truncate" FROM DUAL 
Truncate 
15.7 
SELECT TRUNC(15.79,-1) "Truncate" 
FROM DUAL 
Truncate 
10 
Single Row Single row character functions accept character input and can return 
Character Functions both character and number values. 
Single Row Character This section lists the available character functions that return character 
Functions Returning values: 
Character Values 
CHR Syntax CHR (n) 
Purpose Returns the character having ASCII or EBCDIC 
value n. 
Example SELECT CHR(75) "Character" FROM DUAL 
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Character 





INITCAP 


LOWER 


LPAD 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


INITCAP (char) 


Returns char, with first letter of each word in 
uppercase, all other letters in lowercase. A word is 
delimited by white space. 


SELECT INITCAP('MR, SAMUEL HILLHOUSE’ ) 
"Capitalized" 
FROM DUAL 


Capitalized 


Mr. Samuel Hillhouse 


LOWER (char) 
Returns char, with all letters forced to lowercase. 


SELECT LOWER ('MR. SAMUEL HILLHOUSE’ } 
"Lowercase" 
FROM DUAL 


Lowercase 


mr, samuel hillhouse 


LPAD(chari,n [,char2]}) 


Returns char1, left-padded to length n with the 
sequence of characters in char2; char2 defaults to 
blanks. 


SELECT LPAD(’Page 1',14,'*.') 
“LPAD example" 
FROM DUAL 


LPAD example 


ate. * Page 1 
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LTRIM Syntax 
Purpose 


Example 


REPLACE Syntax 


Purpose 


Example 
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LTRIM(char[, set) 


Removes characters from the left of char, with 
initial characters removed up to the first character 
not in set. Set defaults to ’¥. 


SELECT LTRIM('xxxXxxLAST WORD’,‘’x’) 
“Left trim example" 
FROM DUAL 


Left trim example 


XxxLAST WORD 


REPLACE (char, search string 
[, replacement_string]) 


Returns char with every occurrence of search_ 
string replaced with replacement_string. If 
replacement_string is not supplied, all occurrences 
of search_string are removed. If neither the 
search_string or the replacement_string are specified, 
the function returns NULL. The REPLACE 
function provides a superset of the functionality 
provided by the TRANSLATE function. 
TRANSLATE provides single character, one to 
one, substitution. REPLACE allows you to 
substitute one string for another as well as to 
remove character strings. 


SELECT REPLACE (‘JACK & JUE','J','BL’) 
"Changes" 
FROM DUAL 


Changes 


BLACK & BLUE 








RPAD 


RTRIM 


SOUNDEX 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


RPAD(chari,n [,char2}) 


Returns charl, right-padded to length n with the 
characters in char2, replicated as many times as 
necessary; if char2 is omitted, right-pad with 
blanks. 


SELECT RPAD(‘ENAME',10,'x’) "RPAD example" 
FROM EMP 
WHERE ENAME = ’ TURNER’ 


RPAD example 


TURNERXXXX 


RTRIM(char, [set]) 


Returns char, with final characters removed after 
the last character not in set. set is optional; it 
defaults to ’’. 


SELECT RTRIM(’ TURNERXXXxx!,'x!’) 
"Right trim example" 
FROM DUAL 


Right trim example 


TURNERXXX 


SOUNDEX (char) 


Returns a character string representing the sound 

of the word(s) in char. This function returns a 

phonetic representation of each word and allows 

ree to compare words that are spelled differently, 
ut sound alike. 


SELECT ENAME 

FROM EMP 
WHERE SOUNDEX(ENAME) = 
SOUNDEX (! SMYTHE’ } 
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SUBSTR Syntax 
Purpose 


Example 


TRANSLATE Syntax 
Purpose 


Example 


UPPER Syntax 
Purpose 


Example 


4-18 SQL Language Reference Manual 


SUBSTR(char, m[,n)) 


Returns a portion of char, beginning at character m, 
n.characters long (if n is omitted, to the end of 
char). The first position of char is 1. 


SELECT SUBSTR('ABCDEFG’,2,3) "Substring" 
FROM DUAL ‘~~ 


Substring 


TRANSLATE (char, from, to) 


Returns char after replacing all occurrences of from 
with the corresponding characters in fo. 
Unmatched characters are not affected. 
TRANSLATE will not remove characters. 


SELECT TRANSLATE (’ HELLO! THERE!’,'!',‘/=") 
"Translate example" 
FROM DUAL 


Translate example 


HELLO- THERE- 


UPPER (char) 
Returns char, with all letters forced to uppercase. 


SELECT UPPER('Mr. Rogers’) FROM DUAL 


UPPER(’Mr, Rogers’) 


MR. ROGERS 





Single Row Character 
Functions Returning 
Numeric Values 


ASCII 


INSTR 


LENGTH 


The section lists character functions that return numeric values: 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 
Example 


ASCII (char) 


Collating sequence value of first character of char. 
There is no corresponding EBCDIC function; on 
EBCDIC systems, the ASCII function will return 
EBCDIC collating sequence values. 


SELECT ASCII(‘Q‘) FROM DUAL 


ASCII(‘Q') 


INSTR(charl, char2{,n[,m]}} 


The position of the mth occurrence of char2 in 
char1, beginning search at position n. If mis 
omitted, "1" is assumed. If 2 is omitted, "1" is 
assumed. Position is given relative to the first 


character of char1, even when n>1. . 
af 1 2% 
SELECT INSTR ('MISSISSIPPI','S', 5,2) 
"In string example" 7 
FROM DUAL 


In string example 


LENGTH (char) 
The length of char. 


SELECT LENGTH(’ELEPHANT’) "Length" 
FROM DUAL 
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NLSSORT 


Group Functions 


AVG 


Syntax NLSSORT (char) 


Purpose Returns the collating sequence value of char based 
on the site-specific National Language. For 
information on National Language Support, refer 
to Appendix F "National Language Support" of the 
ORACLE RDBMS Database Administrator's Guide. 


Example SELECT NLSSORT(‘'Q’} “Sequence #" FROM DUAL 


Sequence # 


Group functions return results based on groups of rows, rather than one 
result per row as returned by single row functions. By default, the 
entire result is treated as one group. The GROUP BY clause of the 
SELECT statement is used to divide the result into smaller groups. 


DISTINCT makes a group function consider only distinct values of the 
expression; ALL makes it consider all values including all duplicates. 
For example, the DISTINCT average of 1, 1, 1, and 3 is 1.5; the ALL 
average is 2. If neither option is specified, the default is ALL. 


All of the following group functions skip null values except COUNT). 


The datatype of the arguments may be CHAR, NUMBER or DATE 
where expr is listed. 


Syntax AVG((DISTINCT| ALL] n) 
Purpose Returns average value of n, ignoring null values. 
Example SELECT AVG(SAL) "Average" FROM EMP ; 
Average 
2073 ,21429 
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COUNTCexpr) 


COUNT(*) 


MAX 


MIN 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 
Example 


COUNT ({DISTINCTIALL] expr) 
Returns the number of rows where expr is not null. 


SELECT COUNT(JOBS) "Count" FROM EMP 


SELECT COUNT(DISTINCT JOB) "Jobs" FROM EMP 


Jobs 


5 


COUNT (*) 


Returns the number of rows in the table, including 
duplicates and those with nulls. 


SELECT COUNT(*) “fotal"™ FROM EMP 


MAX (([DISTINCT|ALL) expr) 
Returns maximum value of expr. 
SELECT MAX(SAL) "Maximum" FROM EMP 


Maximum 


MIN ({DISTINCT|ALL} expr) 
Returns minimum value of expr. 


SELECT MIN(HIREDATE) "Minimum Date" 
FROM EMP 


Minimum Date 


17-DEC~80 
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| 
| 


STDDEV Syntax 


SUM 


Purpose 


Example 


Syntax 


Purpose 


Example 


VARIANCE Syntax 


4-22 


Purpose 


Example 
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STDDEV ( (DISTINCT | ALL] 


n) 


Returns standard deviation of n, ignoring null 
values. STDDEV is based on an n-1 (sample) 


calculation. 


SELECT STDDEV(SAL) "Deviation" FROM EMP 


Deviation 


1182.50322 


SUM{[DISTINCTIALL] n)} 


Returns sum of values of n. 


SELECT SUM(SAL) "Total" PROM EMP 


VARIANCE ( (DISTINCT | ALL) n} 


Returns variance of n, ignoring null values. 


SELECT VARIANCE (SAL) 


Variance 


1389313.87 


"Variance" FROM EMP 





Conversion Functions 


CHARTOROWID 


CONVERT 


Conversion functions convert a value from one datatype to another. 
Generally, the format of the functions follows the naming convention 
datatype TO datatype. The first datatype is the datatype of the input 
variable, the last datatype is the datatype of the output variable. If the 
function name only lists an output variable datatype, then the input 
datatype may be any valid ORACLE datatype. 


This section lists the SQL conversion functions: 


Syntax 
Purpose 
Example 


Syntax 


Purpose 


CHARTOROWID (char) 
Converts a value of CHAR datatype to ROWID . 


SELECT ENAME 
FROM EMP 
WHERE ROWID = 


CHARTOROWID (' COOO0000F.0003.0002' ) 


CONVERT (char [,dest_char_set 
{,source_char_set] ] ) 


Converts between two different implementations 
of the same character set. For example, from DEC 
8 bit multi-lingual characters to HP 8 bit multi- 
lingual characters. 


dest_char_set is the name of the character set to 
which the data is to be converted. It can bea 
database column containing the name of the 
character set or a character literal. The default 
value is ’US7ASCII’. 


source_char_set is the name of the character set in 
which the data is stored in the database. It can be 
a database column containing the name of the 
character set or a character literal. The default 
value is the current value of the <char_set> 
argument of the INIT.ORA parameter, 
LANGUAGE. 


For more information on National Language 
Support, refer to Appendix F "National Language 
Support" of the ORACLE RDBMS Database 
Administrator's Guide. 
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Common character sets include: 


US7ASCII 
WES8DEC 
WES8HP 
F7DEC 
WEIBMPC 


Example 


HEXTORAW Syntax 


Purpose 


Example 


RAWTOHEX Syntax 


4-24 


Purpose 


Example 
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the default, US 7-bit ASCII character set 

DEC’s Western European 8-bit ASCII character set 
HP’s Western European 8-bit ASCII character set 
DEC’s French 7-bit ASCII character set 


Western European 8-bit ASCII used on the IBM PC. 


SELECT 
CONVERT (‘NEW WORD’, ’US7ASCII’, 'WESHP' ) 
"Conversion" 

FROM DUAL 


Conversion 


NEW WORD 


HEXTORAW (char) 


Converts a character value containing hexadecimal 
digits to a binary value (suitable for inclusion in a 
RAW column). 


INSERT INTO GRAPHICS (RAW COLUMN) 
SELECT HEXTORAW(‘ 7D!) 
FROM DUAL 

RAWTOHEX ( raw’ 


Converts raw to a character value containing a 
hexadecimal number. 


SELECT RAWTOHEX (RAW COLUMN) "Graphics" 
FROM GRAPHICS 





ROWIDTOCHAR 


TO_CHAR, number 
conversion 


TO_CHAR, date 
conversion 


Syntax 
Purpose 


Example 


Syntax 


Purpose 


Example 


Syntax 
Purpose 


Example 


ROWIDTOCHAR ( rowid) 


Converts ROWID values to CHAR datatype. The 
result of this conversion is always 18 characters long. 


SELECT ROWID 
FROM GRAPHICS 
WHERE ROWIDTOCHAR(ROWID) LIKE '%F38%' 


OOO00F38.0001.0001 
TO_CHAR(n[, fmt}) 


Converts a value of NUMBER datatype to a value 
of CHAR datatype, using the optional format 
string. fmt must be a number format. For 
information about fmt, refer to the section "Format 
Models’ later in this chapter. If fit is omitted, n is 
converted to a char value exactly long enough to 
hold the significant digits. 


SELECT TO_CHAR(17145,'$099,999') "Char" 
FROM DUAL 


$017,145 
TO_CHAR(d[, fmt]) 


Converts a value of DATE datatype to a CHAR 
value in the format specified by the char value fmt. 
fmt must be a date format. For information about 
fit, refer to the section "Format Models" later in 
this chapter. If fmt is omitted, d is converted to a 
CHAR value in ORACLE’s default date format, 
“DD-MON-YY". 


The format of the result as well as the number of 
characters returned by TO_CHAR are determined 
by the format specified by fmt. 


SELECT TO_CHAR(HIREDATE,’Month DD, YYYY’) 
"New date format" 
FROM EMP WHERE ENAME = ‘SMITH’ 


New date format 


December 17, 1980 
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TO_DATE 


TO_NUMBER 


Date Functions 


ADD_MONTHS 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


TO_DATE (char[, fmt]} 


Converts char to a date value. The current month, 
year, etc. are used to provide components of the 
date not explicitly determined from the arguments. 
fmt is a char value in date format specifying the 
format of char. For information about fmt, refer to 
the section "Format Models" later in this chapter. 

If fmt is omitted, char must have the default format, 
"DD-MON-YY". If fmt is J, for Julian, then char 
should actually be a number. 


INSERT INTO BONUS (BONUS_DATE) 
SELECT TO_DATE (‘January 15, 1989’, 
‘Month dd, YYYY') 
FROM DUAL 


TO_NUMBER (char) 


Converts char, a character value containing a 
number, to a value of NUMBER datatype. 


UPDATE EMP 
SET SAL = SAL + 
TO_NUMBER (SUBSTR (‘$100 raise’,2,3)) 
WHERE ENAME = ‘BLAKE’ 


Date functions operate on ORACLE dates. All date functions return a 
value of DATE datatype except the MONTHS_BETWEEN function 
which returns a numeric value. 


Syntax 
Purpose 


Example 
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ADD_MONTHS (d, n) 


Returns the date d plus n months. n must be an 
integer, and can be negative. 


SELECT ADD_MONTHS(HIREDATE,12) "Next year" 
FROM EMP 
WHERE ENAME = ‘SMITH! 


Next year 


17-DEC-81 





LAST_DAY 


MONTHS_BETWEEN 


NEW_TIME 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


LAST_DAY (a) 
Returns the date of last day of month containing d. 


Useful in determining how many days there are in 
a given month. 


SELECT LAST _DAY(SYSDATE) “Last™ FROM DUAL 


31-AUG-89 


MONTHS BETWEEN (d, e} 


Returns number of months between dates d and e. 
If dis later than e, result is positive; if earlier, 
negative. The non-integer portion of the result is 
that portion of a 31-day month. 


SELECT 
MONTHS BETWEEN (/ 02-feb-86','01-jan-86')) 
"Months" 

FROM DUAL 


Months 


1.03225806 


NEW_TIME (d, a,b) 

Returns date and time in time zone b when date 

and time in time zone a are d. a and b are character 

expressions with the following meaning: 

AST, ADT Atlantic Standard or Daylight 
Time. 


BST, BDT Bering Standard or Daylight Time. 


CST, CDT Central Standard or Daylight Time. 
EST, EDT Eastern Standard or Daylight Time. 


GMT Greenwich Mean Time 

HST, HDT Alaska-Hawaii Standard Time, 
Daylight Time. 

MST, MDT Mountain Standard or Daylight 
Time. 

NST Newfoundland Standard Time. 


PST, PDT Pacific Standard or Daylight Time. 
YST, YDT Yukon Standard or Daylight Time. 
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Example 


NEXT_DAY Syntax 
Purpose 


Example 


ROUND Syntax 
Purpose 


Example 
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SELECT 
TO_CHAR( 
NEW_TIME (TO_DATE(117:47', /hh24:mi'), 
'PST', 'GMT'}, 
‘hh24:mi') "GREENWICH TIME" 
FROM DUAL 


GREENWICH TIME 


NEXT_DAY (d, char) 


Returns date of first day of week named by char 
that is later than d. char must be a valid day of the 
week. 


The following example returns the date of the next 
Tuesday after March 17, 1989. 


SELECT NEXT_DAY (‘17-MAR-89', ‘ TUESDAY’ ) 
"NEXT DAY" 
FROM DUAL 


NEXT DAY 


21-MAR-89 
ROUND (d(, fmt]) 


Returns d rounded as specified by the rounding 
unit fmt. fmt defaults to the nearest day. 


For details on ROUND and TRUNC, refer to the 


section "ROUND and TRUNC" later in this chapter. 


SELECT ROUND (TO_DATE ('27-OCT-88'),‘ YEAR‘) 
"FIRST OF THE YEAR" 
FROM DUAL 


PIRST OF THE YEAR 


01-JAN-89 


SYSDATE 


TRUNC 


ROUND and TRUNC 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


SYSDATE 


Returns the current date and time. Requires no 
arguments. 


SELECT SYSDATE FROM DUAL 


SYSDATE 


19-MAR-89 


TRUNC (d, {.fmt}) 


Returns d with the time portion of the day 
truncated up to the specified truncation unit, fmt. 
The default is to remove the time component of the 
day. Refer to the next section "ROUND and 
TRUNC." 

SELECT TRUNC(TO_DATE (‘ 28-OCT-88" ,' YEAR’ ) 


"First Of The Year" 
FROM DUAL 


FIRST OF THE YEAR 


01-JAN-88 


For ROUND and TRUNC, the following table lists the unit of rounding 
or truncation for the corresponding format model. The default is "dd" 
and means that the time portion of the date is set to midnight. 








Format Model Unit 

cc, SCC century 

SYYY, YYYY, YEAR, year (rounds up on July 1) 
SYEAR, YYY, YY, Y 

Q quarter (rounds up on 2nd month/16th) 
MONTH, MON, MM month (rounds up on 16th) 
WW start of week of YEAR 

WwW start of week of MONTH 
DDD, DD, J day 

DAY, DY, D nearest Sunday 

HH, HH12, HH24 hour 

MI minute 
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Other Functions 


DECODE Syntax 
Purpose 
Example 

DUMP Syntax 
Purpose 
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DECODE (expr, searchl, resultl, 
(search2, result2,] 
[defauit} } 


The expr is compared to each search value and 
returns the result if expr equals the search value. If 
no match is found, the DECODE function returns 
the default value. If a default is not supplied, the 
default will return null. 


expr may be any datatype; search should be the 
same datatype as expr. The value returned is forced 
to the same datatype as the first result. 


The following example displays employees and 
their manager’s name. If no matches are found, 
then NONE is returned for MGR. 


SELECT ENAME, DECODE (MGR, 7934,‘'SMITH’, 
7251,' JONES’ ,7839,' KING ,‘NONE’) Mgr 


FROM EMP 
ENAME Mgr 
JONES KING 
CLARK KING 
OAKLEY NONE 
FORD JONES 


DUMP (expr [,display format 
{,start_position [, length]] ] ) 


Displays the value of an expression in internal 
format. Valid values for display_format are 8 for 
octal, 10 for decimal, 16 for hex, 17 for character. 
start_position and length combine to determine 
which portion of the result to display. The default 
is to display the entire result. 


Examples 





SELECT DUMP (ENAME) "ASCII" 
FROM EMP 
WHERE ENAME = ' SCOTT! 


Type=1 Len=5: 83,67,79,84,84 


SELECT DUMP (ENAME,8) "“OCTAL" 
FROM EMP 
WHERE ENAME = ‘SCOTTY 


Type=1 Len=5; 123,103,117,124,124 


SELECT DUMP (ENAME,16) “HEX” 
FROM EMP 
WHERE ENAME = ‘SCOTT’ 


Type=1 Len#5: 53,43,4£,54,54 


SELECT DUMP (ENAME,17) “CHAR" 
FROM EMP 
WHERE ENAME = ‘SCOTT’ 





Type=1 Len=5: $,C,0,T,T 


GREATEST Syntax GREATEST (expr [,expr] ...) 


Purpose Returns the greatest of a list of values. All exprs 
after the first are converted to the datatype of the 
first before the comparison is done. 


Example SELECT GREATEST (‘ HARRY’, ‘HARRIOT! , ‘HAROLD! 
"GREATEST" 
FROM DUAL 


GREATEST 


HARRIOT 
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LEAST Syntax 
Purpose 


Example 


NVL Syntax 
Purpose 


Example 


UID Syntax 
Purpose 


Example 
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LEAST (expr [{,expr} ...) 


Returns the least of a list of values. All exprs after 
the first are converted to the datatype of the first 
before the comparison. 


SELECT LEAST (‘ HARRY’, ’HARRIOT’ ,* HAROLD® ) 
"LEAST" 
FROM DUAL 


HAROLD 


NVL(expril, expr2) 
If exprl is null, returns expr2; if exprl is not null, 


returns exprl. exprl and expr2 may be of any type. 


The datatype of the returned value must be the 
same datatype as expr1. 


SELECT ENAME, 
NVL(TO_CHAR (COMM), ’NOT APPLICABLE’ ) 
"COMMISSION" 

FROM EMP 

WHERE DEPTNO = 30 


ENAME COMMISSION 
ALLEN 300 

WARD 500 

MARTIN 1400 

BLAKE NOT APPLICABLE 
TURNER 0 

JAMES NOT APPLICABLE 
UID 


Returns the unique integer assigned to each 
username (there is one UID value per username). 
Requires no arguments. 


SELECT USER, UID FROM DUAL 


OPSSKING 9 





USER 


USERENV 


VSIZE 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


Syntax 
Purpose 


Example 


USER 


Returns the username of the current ORACLE 
user. Requires no arguments. 


SELECT USER, UID FROM DUAL 


USER UID 
OPSSKING 9 
USERENV (option) 


Returns information of CHAR datatype about the 
user and/or session that is useful for writing an 
application-specific audit trail table. This table 
shows the value returned for each valid option: 


option _—Value returned 

"ENTRYID’ Available auditing entry identifier 
SESSIONID’ User's auditing session identifier 
’TERMINAL’ _ User’s terminal’s operating system 





identifier 
"LANGUAGE’ Language in use, as determined by 
the INIT.ORA parameter 
LANGUAGE. 
SELECT USERENV('LANGUAGE’) "Language" 
FROM DUAL; 


Language 


AMERICAN, AMERICA.US7ASCII 


VSIZE (expr) 


Returns the number of bytes used to store 
ORACLE’ internal representation of expr. 
SELECT ENAME, VSIZE(ENAME) "BYTES" 


FROM EMP 
WHERE DEPTNO = 10 


ENAME BYTES 
CLARK 5 
KING 4 
MILLER 6 


Operators and Functions 4-33 





Format Models 


Change the Display 
Format 


Format models are used for two different purposes: 


* to change the display format of a column 


¢ to supply a value to ORACLE in the format other than the 
default format. 


Format models are used in the TO_CHAR and TO_DATE functions. 
Multiple format models may be used within a single TOLCHAR or 
TO_DATE function. 


Format models may be used to affect how column values are displayed 
when retrieved with a SELECT statement. Format models do not affect 
the actual internal representation of the column. 


For example, to display the commission of every department 30 
employee in the EMP table using leading dollar signs, commas every 
three digits, and two decimal places, enter: 

SELECT ENAME EMPLOYEE, TO_CHAR{COMM,’ $0,999.99’) COMMISSION 


FROM EMP 
WHERE DEPTNO = 30 


EMPLOYEE COMMISSION 


ALLEN $300.00 
WARD $500.00 
MARTIN $1,400.00 
BLAKE 
TURNER $0.00 
JAMES 


Note that the TO_CHAR function returns a NULL for all employees 
with a NULL commission. To substitute 0 for all NULL commissions, 
refer to the description of the NVL function earlier in this chapter. Also 
note that four different number format models were used ("$", "9", "0" 
and "."). 
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Supply the Correct Format 


TO_NUMBER Function 


Number Formats 


To display the hire date of all department 20 employees with the 
month spelled out and the century included in the year, enter: 
SELECT ENAME, TO_CHAR(HIREDATE,’fmMonth DD, YYYY’) HIREDATE 


FROM EMP 
WHERE DEPTNO = 20 


ENAME HIREDATE 

SMITH December 17, 1980 
JONES April 2, 1981 
scorr February 15, 1988 
ADAMS March 20, 1988 
FORD December 3, 1981 


Format models can also be used to change a value into the format that 
ORACLE expects. When inserting into or updating a table, ORACLE 
expects to be passed values with datatypes that correspond to the 
column’s datatype. For example, when you insert a date, ORACLE 
expects to be passed a date or a character string with the default date 
format of DD-MON-YY. If you do not use the default date format, you 
must use the TO_DATE function and the appropriate format models. 


To update JONES’ hiredate to 20-May-88 and use a non-standard date 
format, enter: 
UPDATE EMP 


SET HIREDATE = TO_DATE(’88 05 20',’YY MM DD’) 
WHERE ENAME = ’ JONES’ 


The TO_NUMBER function does not accept format models. All 
character string expressions used in the TO_LNUMBER function must 
result in a valid number as defined in Chapter 5 "SQL Statement 
Reference" of this Manual. 


Number formats are used in conjunction with the TO_CHAR function 
to translate values of NUMBER datatype to CHARACTER datatype. 
Number formats are only used with the TO_CHAR function. The 
translation from NUMBER to CHARACTER may occur when 
displaying values or when passing values to ORACLE. 


All number formats cause the number to be rounded to the specified 
number of significant digits. 


If a value has more digits to the left of the decimal place than are 
specified in the format, asterisks replace the value. 
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The following table lists the possible elements of a number format 


Description 





model: 

Element Example 
9 9999 

0 0999 

$ $9999 

B B9999 
MI 9999MI 
PR 9999PR 


comma 9,999 
period 99.99 


Vv 999V99 


E 9.999EEEE 


DATE DATE 


Date Formats 


Number of "9"s determines display width. 
Display leading zeroes. 

Prefix value with dollar sign. 

Display zero value as blank, not "0". 
Display "-" after a negative value. 


Display a negative value in <angle 
brackets>. 

Display a comma in this position. 

Display a decimal point in this position. 
Multiply value by 10n, where n is the 
number of "9"s after the "V". 

Display in scientific notation (format must 
contain exactly four "E"s). 

For dates stored in number values 
(ORACLE Version 2). Displayed as a date in 
'"MM/DD/YY’ format. 


Date formats are used by the TO_CHAR function to display a date ina 


different format. Date formats are used in the TO_DATE function to 
supply values to ORACLE in a nonstandard date format. The standard 
date format is DD-MON-YY, 


The following table lists the elements of a date format model: 


Element 


SCC or CC 
YYYY or SYYYY 
YYY or YY or Y 
Y,YYY 

SYEAR or YEAR 


BC or AD 
B.C. or A.D. 


Q 
MM 
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Meaning 


Century; "S" prefixes "BC" date with "-". 
4-digit year; "S" prefixes "BC" date with "-". 
Last 3, 2, or 1 digit(s) of year. 

Year with comma in this position. 

Year, spelled out; "S" prefixes "BC" date with 


BC/AD indicator. 

BC/AD indicator with periods. 

Quarter of year (1, 2, 3, 4; JAN-MAR = 1). 
Month (01-12; JAN = 01). 


Element 


Meaning 





MONTH 


MON 
WW 


WwW 


AM or PM 
A.M. or P.M 
HH or HH12 
HH24 

MI 

ss 

SSSSS 

fescgls 


mow 


Name of month, padded with blanks to 
length of 9 characters. 


Name of month, 3-letter abbreviation. 


Week of year (1-52) where week 1 starts on 
the first day of the year and continues to the 
seventh day of the year. 


Week of month (1-5) where week 1 starts on 
the first of the month and continues to the 
seventh of the month. 


Day of year (1-366). 
Day of month (1-31). 
Day of week (1-7). 


Name of day, padded with blanks to length 
of 9 characters, 


Name of day, 3-letter abbreviation. 


Julian day; the number of days since January 
1,4712 BC. 


Meridian indicator. 

Meridian indicator with periods. 

Hour of day (1-12). 

Hour of day (0-23). 

Minute (0-59). 

Second (0-59). 

Seconds past midnight (0-86399). 
Punctuation is reproduced in the result. 
Quoted string is reproduced in the result. 


This prefix can be added to format elements for the TO_CHAR function: 


FM 


"Fill mode." This prefix suppresses blank padding 
for all subsequent character elements (such as 
MONTH) and suppresses leading zeroes for all 
subsequent number elements (such as MI) in a date 
format model. The TO_CHAR function returns a 
variable length result. 


FM isa toggle. If FM appears twice in a date 
format model, blank padding and leading zeroes 
are suppressed for elements after the first FM and 
reenable for elements after the second. 
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The following suffixes can be added to the previous codes for the 
TO_CHAR function: 


TH Ordinal number (e.g., "DDTH" for "4TH"). 

SP Spelled-out number (e.g., "DDSP" for "FOUR"). 

SPTH or THSP Spelled-out ordinal number (e.g.,"DDSPTH" for 
"FOURTH"). 


Capitalization in a spelled-out word or abbreviation follows 
capitalization in the corresponding format element. For example, 
"DAY" in a format model produces capitalized words like "MONDAY"; 
"Day" produces "Monday"; and "day" produces "monday." 


A date format model may also include punctuation characters like 
hyphens, slashes, and commas, and character constants enclosed in 
quotation marks (not apostrophes). Such punctuation characters and 
character constants will be reproduced in the output. For example, the 
format model: 


'DDTH "of" fmMonth, YYYY’ 
produces a date like: 
15TH of March, 1989 


Note that the fill mode (fm) format mask was also used. If omitted, the 
month would be blank padded to 9 characters, as in: 


1STH of March , 1989 


To include an apostrophe in a date format element, use two 
apostrophes in a row. For example: 


SELECT TO_CHAR(sysdate, ’fmDay"’’s Special"’) 
FROM DUAL 


would yield: 


Tuesday's Special 
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Expressions 


An expression is a combination of one or more values, operators, and 

functions which evaluates to a value. An expression generally assumes 
the datatype of its components. For a formal definition of an ORACLE 
expression, refer to the syntax description of expr in the next section of 





this chapter. 


This is an example of a simple expression that evaluates to 4 and has 
datatype NUMBER (the same datatype its components): 


2*2 


This is an example of a more complex expression that uses both 


functions and operators. This expression adds seven days to the current 


date, removes the time component from the sum, and converts the 
result to CHAR datatype: 


TO_CHAR (TRUNC (SYSDATE+7) ) 


You can use an expression almost anywhere you can use a constant 
value. For example, you could an expression in place of the quoted 
string ‘smith’ in this UPDATE statement SET clause: 


SET ENAME = ‘smith’ 


This SET clause has the expression LOWER(ENAME) instead of the 
quoted string ‘smith’: 


SET ENAME = LOWER (ENAMB) 
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Expr 


4-40 


Purpose 
Prerequisites 
Syntax 


Form I 


Examples 


Form I 


Examples 


Form III 


Examples 


A text string, number, or date value or expression. 
None. 
An expression may be: 


A column, constant or special value. 
{table.] { column | ROWID } 
text 

number 

sequence .CURRVAL 

sequence .NEXTVAL 

NULL 

ROWNUM 

LEVEL 

SYSDATE 

UID 

USER 

EMP .ENAME, 

‘this is a text string’ 

lo 

SYSDATE 


A bind variable with optional indicator variable 

: { n | variable } { :ind_variable ] 
temployee_name:employee_name_indicator_var 
idepartment_location 

A function reference (this chapter lists the available functions). 
function_name ( [DISTINCT | ALL} expr [,expr]... ) 


LENGTH (/ BLAKE’ ) 
ROUND (1234.567*43) 
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Form IV 


Examples 


Form V 


Examples 


Usage Notes 


Related Topics 


A combination of other expressions (listed in precedence order). 
(expr) 

+expr, -expr, PRIOR expr 

expr * expr, expr / expr 

expr + expr, expr - expr, expr || expr 
(CLARK! | | ‘SMITH’) 

LENGTH (/MOOSE’) * 57 

SORT (144) + 72 

A parenthesized list of expressions: 

{expr [,expr]... ) 

(10, 20, 40) 

(SCOTT’, ‘BLAKE’, ‘ TAYLOR‘) 

(LENGTH (’MOOSE’) * 57, -SQRT(144) + 72, 69) 
Expressions are used in: 


* the select list of the SELECT statement 
* acondition of the WHERE and HAVING clauses 
* the CONNECT BY, START WITH, and ORDER BY clauses 
* the VALUE clause of the INSERT statement 
¢ the SET clause of the UPDATE statement 
The sections "Functions" earlier in this chapter, and the sections "Text," 


"Integer," and "Number" in Chapter 3 "Elements of the SQL Language" 
of this Manual. 
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Conditions 


A condition is a combination of one or more expressions and logical 
operators that evaluates to either TRUE or FALSE. A condition could 
be said to be of the “Logical” datatype, although ORACLE does not 
formally support such a datatype. For the syntax description of 
condition, refer to the next section of this chapter. 


This example shows a simple condition that always evaluates to TRUE: 
1-1 

This example shows a more complex condition that selects each row’s 
ROWID, converts it to CHAR datatype, concatenates ‘THE ROWID’ to 


the result and then determines if this result is greater or equal to the 
character constant ‘smith’: 


ROWIDTOCHAR(ROWID) || ‘THE ROWID’ >= ‘smith’ 


Logical operators can combine multiple conditions into a single 
condition. For example, you can use the AND operator to combine two 
conditions: 


(1 = 1) AND (5 < 7) 


For more information on how to evaluate conditions with logical 
operators, refer to the section "Logical Operators” earlier in this chapter. 


Conditions are most often used in WHERE clauses of DELETE, 
SELECT, and UPDATE statements. Conditions are also used in START 
WITH, CONNECT BY, and HAVING clauses of SELECT statements. 


Condition 
Purpose 
Prerequisites 
Syntax 
Form I 
4-42 


An element that evaluates to either TRUE or FALSE. 
None. 
A condition may be: 


A comparison with an expression or the result of a query 


<expr> <comparison operator> <expr> 
<expr> <comparison operator> <query> 
<expr-list> <equal-or-not> <expr-List> 


<expr-list> <equal-or-not> <query> 
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Form IT 


Form OT 


Form IV 


Form V 
Form VI 


Form VII 


Usage Notes 


Examples 


Related Topics 





| 
| 
i 
} 
} 
} 
} 


A comparison with any or all members ina list or query 
<expr> <comparison> { ANY | ALL } ( <expr> [, <expr> ]... ) 
<expr> <comparison> { ANY | ALL } <query> 
<expr-list> <equal-or-not> { ANY | ALL } 

(<expr-list> [,<expr-List>]...) 
<expr-list> <equal-or-not> { ANY | ALL } <query> 

A test for membership ina list or query 

<expr> [NOT} IN ( <expr> [, <expr> ]... 

<expr> [NOT] IN <query> 

<expr-list> [NOT] IN ( <expr<list> [, <expr-list> ]... 

<expr<list> [NOT] IN <query> 

A test for inclusion in a range 


<expr> [NOT] BETWEEN <expr> AND <expr> 


A test for a value of NULL 


<expr> IS [NOT] NULL 


A test for existence of rows ina query 


EXISTS <query> 


A combination of other conditions (listed in precedence order) 
{ <condition> ) 

NOT <condition> 

<condition> AND <condition> 


<condition> OR <condition> 


Used in WHERE, START WITH, CONNECT BY and HAVING clauses. 


RENAME = ‘SMITH! 

EMP .DEPTNO = DEPT.DEPTNO 

HIREDATE > '01-JAN-88° 

JOB IN (‘PRESIDENT’, ‘CLERK’, ANALYST’) 

SAL BETWEEN 500 AND 1000 

COMM IS NULL AND SAL = 2000 

SELECT, INSERT, UPDATE, and DELETE statements in Chapter 5 


"SQL Statement Reference"; HAVING and WHERE clauses in Chapter 6 
"SELECT Statement Clauses" of this Manual. 
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CHAPTER 


SOL STATEMENT 
REFERENCE 


his chapter contains detailed descriptions of all SQL Language 

statements. SQL statements may be used in all Oracle products 
with few exceptions. The statements appear alphabetically. The 
description of each statement contains the following sections: 


Purpose 
Prerequisites 
Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 
Related Topics 


describes the basic uses of the statement. 
lists privileges needed to use the statement. 
shows how to enter the statement. The 
notation used in this chapter is explained in 
the Preface of this Manual. 

describes the function of each keyword and 
parameter. A keyword isa string that must 
be entered exactly as listed and is displayed 
in uppercase. A parameter is a placeholder 
for a user-supplied value and is displayed in 
lowercase. 

discusses how and where to use the 
statement. 

provides examples of the statement. 


lists topics of further information. 
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DS Ni al 
Summary of SOL Statements 


Appendix B "SQL Syntax" provides a complete syntax summary of all 
of the SQL statements. The following table is a functional summary of 
SQL statements. The table identifies these types of statements: 


DDL Data Definition Language: statements that affect the 
structure of the database objects and often involve 
the Data Dictionary. ORACLE issues an implicit 
COMMIT before and after every DDL statement. 





DML Data Manipulation Language: statements that 
manipulate data. 

EMB Embedded SQL: statements used to place DDL and 
DML statements within a procedural 
programming language. Embedded SQL is 
supported by the ORACLE Precompilers including 
Pro* Ada, Pro*C, Pro*COBOL, Pro*FORTRAN, 
Pro*Pascal, and Pro*PL/I. 

Statement Type New Description 

re A Places a comment within or at the 
end of a SQL statement. 

ALTER CLUSTER DDL Y Redefines cluster storage 
parameters. 

ALTER DATABASE DDL Y Opens/closes, mounts/ 
dismounts, or renames database 
files; turns archiving on/off; 
adds/drops redo log files. 

ALTER INDEX DDL Y __ Redefines future storage allocation 
for an index. 

ALTERROLLBACK DDL Y _ Redefines future storage allocation 

SEGMENT ; for a rollback segment. 

ALTERSEQUENCE DDL Y _ Redefines sequence number 
generation. 

ALTER SESSION DDL Y Alters the current user session. 

ALTER TABLE DDL Adds a column to a table, 
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redefines a column in an existing 
table, or redefines future storage 
allocation. 





Statement Type New Description 

ALTERTABLESPACE DDL Y Takes tablespace off/online, sets 
begin/end of backup, adds/ 
renames database file associated 
with the tablespace, alters storage 
allocation. 

ALTER USER DDL Y Changes user’s password, default 
tablespace or default temporary 
tablespace. 

AUDIT DDL Enables auditing of specified 
database resources. 

CLOSE CURSOR EMB Releases resources held by a 
cursor. 

COMMENT DDL Inserts a comment about a table or 
column into the Data Dictionary. 

COMMIT DML Y = Makes permanent all changes 
since the beginning of the 
transaction. 

CONNECT EMB Connects user to the ORACLE 
RDBMS. 

CREATECLUSTER DDL Creates a cluster which may 
contain one or more tables. 

CREATEDATABASE DDL Y Creates a database and prepares it 
for use. 

CREATE DATABASE DDL Creates a link to a username ina 

LINK remote database. 

CREATE INDEX DDL Creates an index for a table. 

CREATE ROLLBACK DDL Y Creates a rollback segment ina 

SEGMENT tablespace. 

CREATESEQUENCE DDL Y Creates a sequence suitable for 
generation of primary keys. 

CREATE SYNONYM DDL Creates a synonym for a table or 
view name. 

CREATE TABLE DDL Creates a table and defines its 
columns and storage allocation. 

CREATE DDL Y Creates area in database for 

TABLESPACE storage of tables, indexes and 
rollback and temporary segments, 
naming the file(s) to comprise the 
tablespace. 

CREATE VIEW DDL Defines a view of one or more 


tables and/or other views. 
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Statement 


Type New Description 





DECLARE CURSOR 


DECLARE 
DATABASE 


DECLARE 
STATEMENT 
DESCRIBE 
DELETE 


DROP object 


EXECUTE 


EXECUTE 
IMMEDIATE 


EXPLAIN PLAN 


FETCH 
GRANT 


INSERT 
LOCK TABLE 


NOAUDIT 


OPEN cursor 


PREPARE 
RENAME 
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EMB 


EMB 


EMB 


EMB 


DML 


DDL 


EMB 


EMB 


EMB 
DDL 


DML 


* DML 


DDL 


EMB 


EMB 
DDL 


Defines a cursor. 

Declares the name of a remote 
database for reference in 
subsequent SQL statements. 
Assigns a SQL variable name to a 
SQL statement. 

Initializes a descriptor to hold host 
variable descriptions. 

Removes all or selected rows from 
a table. 

Removes a cluster, database link, 
index, rollback segment, sequence, 
synonym, table, tablespace, or 
view from the database. 

Executes any dynamic SQL 
statement. 

Prepares and executes a SQL 
statement that contains no host 
variables. 

Shows the execution plan for a 
SQL statement. 


Retrieves data from the database. 


Creates new ORACLE usernames, 
assigns passwords, grants 
ORACLE privileges to users. 
Grants table privileges to users. 
Grants resource privileges on 
tablespaces to users. 

Adds new rows to a table or view. 


Locks a table, temporarily limiting 
access to it by other users. 
Disables auditing by reversing, 
partially or completely, the effect 
ofa prior AUDIT statement, or of 
auditing options. 

Allocates a previously defined 
cursor. 

Parses a SQL statement. 


Changes the name of a table, view, 
or synonym. 


Statement 


Type New Description 





REVOKE 


ROLLBACK 


SAVEPOINT 


SELECT 


SET TRANSACTION 
UPDATE 
VALIDATE INDEX 
WHENEVER 


DDL 


DML Y 


DML Y 


DML 


DDL Y 
DML 
DDL 
EMB 


Revokes database privileges or 
table access privileges from users. 


Undoes all changes back to a 
savepoint or since the beginning of 
the transaction. 


Sets a point to which you may 
rollback. 


Performs a query; selects rows and 
columns from one or more tables. 


Starts a read consistent transaction. 
Changes data in a table. 
Checks the integrity of an index. 


Specifies how error and warning 
conditions are to be handled. 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topic 


Comments can be included to clarify the operation of a SQL statement, 
but they have no effect on the operation of the SQL statement. 


None; comments can be included in any SQL statement. 


/* text */ 


text a string containing printable characters from the 
character set of your operating system, e.g. ASCIT 
or EBCDIC. 


Comments may appear within any SQL statement. ("Within" means 
between words). 


/* begins a comment and */ ends it. A comment may span any 
number of lines, and may begin or end in the middle of a line. "/*" 
need not be followed by a space or line break, and "*/" need not be 
preceded by one. 


The following SELECT statement contains several comments: 


SELECT ENAME, SAL+COMM COMP, JOB, LOC 
/* Select all employees whose compensation is 
greater than that of Jones. */ 
FROM EMP, DEPT 
/* DEPT is used to get department name. */ 
WHERE EMP.DEPTNO = DEPT.DEPTNO 


AND SAL + COMM > 7* Subquery: */ 
(SELECT SAL + COMM /* COMP = SAL + COMM */ 
FROM EMP /* Jones's */ 
WHERE ENAME = /JONES’) /* compensation */ 

COMMENT statement. 
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ALTER CLUSTER 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Redefine future storage allocations for a cluster. 


You must own the cluster cr have DBA privilege to alter a cluster that 
you do not own. 


ALTER CLUSTER [user.]cluster 
{PCTUSED integer} [PCTFREE integer] 
{SIZE integer] 
{INITRANS integer] [MAXTRANS integer] 
{STORAGE storage] 


user is the username of the cluster’s owner. 
cluster is the name of the cluster. 


PCTUSED integer (Refer to the PCTUSED parameter of the CREATE 
TABLE statement later in this chapter.) 


PCTFREE integer (Refer to the PCTFREE parameter of the CREATE 
TABLE statement later in this chapter.) 


SIZE integer determines how many cluster keys will be stored 
in ORACLE blocks allocated to the cluster. Fora 
complete description of SIZE, refer to the CREATE 
CLUSTER statement later in this chapter. 


INITRANS integer (Refer to the INITRANS parameter of the CREATE 
TABLE statement later in this chapter.) 


MAXTRANS (Refer to the MAXTRANS parameter of the 
integer CREATE TABLE statement later in this chapter.) 


STORAGE storage (Refer to the Storage clause later in this chapter.) 


Using ALTER CLUSTER, you can: 
* change PCTUSED and PCTFREE for future cluster blocks 
* change the SIZE of future cluster blocks 
* change INITRANS and MAXTRANS for future cluster blocks 


* change future storage allocations with the NEXT, 
PCTINCREASE, MAXEXTENTS parameters 
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Using ALTER CLUSTER you cannot: 


change the number or the name of columns in the cluster key 
alter the MINEXTENTS parameter 

change any parameters relating to blocks already allocated to 
the cluster 

remove tables from a cluster (see the DROP CLUSTER and 
DROP TABLE statements) 


alter the tablespace to which the cluster belongs 


Example To alter SCOTI’S CUSTOMER cluster so that future ORACLE blocks 
within this cluster contain 4 cluster keys per ORACLE block (assuming 
an ORACLE block size of 2 kilobytes, 2K /(SIZE of 512) = 4), and to set 
MAXEXTENTS to 25, enter: 

ALTER CLUSTER SCOTT.CUSTOMER 


SIZE $12 
STORAGE (MAXEXTENTS 25) 


Related Topics CREATE CLUSTER and CREATE TABLE statements; Storage clause. 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Alter an existing database in several ways: 


« mount a database, either shared or exclusive 
* open or close a database 

+ add or drop a redo log file 

* rename a redo log file or a database file 


* specify that the redo log will be archived and thus useful for 
media recovery, or will not be archived and thus useful only 
for instance recovery 


Requires DBA privilege. 


ALTER DATABASE [ database ] 

{ADD LOGFILE filespec [, filespec] ... 

|DROP LOGFILE ‘filename’ [,’filename’] ... 

|RENAME FILE ‘filename’ {,’filename’] ... 
TO 'filename’ [,’filename’] ... 

| ARCHIVELOG 

| NOARCHIVELOG 

|MOUNT [EXCLUSIVE | SHARED] 

[DISMOUNT 

| OPEN 

ICLOSE [NORMAL | IMMEDIATE] } 


database is an identifier for the database which cannot 
exceed 8 characters in length. If omitted, the value 
for the parameter DB_NAME in the current 
INIT.ORA file is assumed. This identifier is not 
related to the SQL*Net database specification. 


ADDLOGFILE _ isa specification of a database file in the form: 
filespec filename’ (SIZE integer [KIM]] [REUSE] 
integer specifies a SIZE in a number of bytes. No 
integer means ORACLE will use the default logfile 
size of 500K. If the integer is followed by K, then 


SIZE is computed as the integer multiplied by 1024. 


If M is used, then SIZE is integer multiplied by 
1048576. 


DROP LOGFILE _ is the name of a current redo log file to be dropped. 


filename 

RENAME FILE specifies old and new file names for database files. 
filename TO New filenames must conform to your standard 
filename operating system file naming conventions. 
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ARCHIVELOG enables and disables archiving, respectively. 


NOARCHIVELOG 
MOUNT indicates whether to change the status of the 
DISMOUNT database to MOUNTed or to DISMOUNTed. A 


database must be both MOUNTed and OPEN for 
most activities. Some DBA maintenance functions 
require the database to be MOUNTed but not 
OPEN. 


For additional details of the MOUNT clause, refer 
to the ORACLE RDBMS Database Administrator's 


Guide 
OPEN indicates whether the database should be OPEN 
CLOSE and available for normal access or CLOSEd and 


unavailable for normal use. 


For a complete description of the OPEN clause, 
refer to the ORACLE RDBMS Database 
Administrator's Guide 


Usage Notes Valid options depend on the current state of the database. 


If the database is: You may use: 

not mounted MOUNT only 

mounted but not open all arguments except MOUNT and CLOSE 
open CLOSE only 


SIZE and REUSE _ If SIZE is specified and REUSE is omitted, the file is to be created with 
the specified size and must not already exist. If both SIZE and REUSE 
are specified, the file should be created if it does not exist, but if it exists 
the size is to be checked. The use of REUSE alone or no options 
indicates that the file must already exist and should be used as is. 


Some arguments may require additional tasks of the DBA, such as 
allocating and preparing files for the REUSE option, or taking a 
backup, if enabling ARCHIVELOG mode. 


Generally, it is recommended that the database be both closed and 
dismounted when ALTERing the DATABASE. For additional 
information on the ALTER DATABASE statement, refer to the 
ORACLE RDBMS Database Administrator's Guide. 
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Examples 


Related Topics 


ALTER DATABASE 


To mount a database exclusively: 

ALTER DATABASE dbname MOUNT EXCLUSIVE 

To open the currently mounted database: 

ALTER DATABASE OPEN 

To switch modes such that you will archive redo logs: 
ALTER DATABASE ARCHIVELOG 

To add a log file: 


ALTER DATABASE 

ADD LOGFILE ‘dblog3.log’ SIZE 50000 
CREATE DATABASE statement; SQL*DBA commands: STARTUP and 
SHUTDOWN (in Appendix B "The SQL*DBA Reference" of the 
ORACLE RDBMS Database Administrator's Guide). 
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ALTER INDEX 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Change future storage allocation for index blocks. 
You must be the owner of the index or have DBA privilege. 


ALTER INDEX [user.]index 
[INITRANS integer] [MAXTRANS integer] 
[STORAGE storage] 


user is the username of the index owner. 
index is the name of the index. 


INITRANS integer (Refer to the INITRANS parameter of the CREATE 
TABLE statement later in this chapter.) 


MAXTRANS (Refer to the MAXTRANS parameter of the 
integer CREATE TABLE statement later in this chapter.) 


STORAGE storage (Refer to the Storage clause later in this chapter.) 


INITRANS, MAXTRANS, and STORAGE all have the same function as 
in the CREATE TABLE statement. 


To alter SCOTT’S CUSTOMER index so that future ORACLE blocks 
within this index use 5 initial transaction entries and an incremental 
extent of 100K bytes, enter: 

ALTER INDEX SCOTT .CUSTOMER 


INITRANS 5 
STORAGE (NEXT 100K) 


CREATE INDEX and CREATE TABLE statements; Storage clause. 
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ALTER ROLLBACK SEGMENT 


Purpose 
Prerequisite 
Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Alter the storage parameters of an existing rollback segment. 
Requires DBA privilege. 
ALTER {PUBLIC] ROLLBACK SEGMENT rollback_segment 

STORAGE storage 


PUBLIC specifies that the existing rollback segment is 
PUBLIC. 


rollback_segment specifies the name of an existing rollback segment. 


STORAGE storage (Refer to the Storage clause later in this chapter.) 


The STORAGE clause of the ALTER ROLLBACK SEGMENT statement 
affects future space allocation in the specified rollback segment. 
Therefore, INITIAL and MINEXTENTS cannot be used to alter an 
existing rollback segment. 


Note that you cannot use the ALTER ROLLBACK SEGMENT 
statement to make a private rollback segment PUBLIC or make a 
PUBLIC rollback segment private. To make such changes, you must 
drop and recreate the rollback segment. 


To change the storage parameters for a private rollback segment named 
RSONE: 


ALTER ROLLBACK SEGMENT RSONE 
STORAGE (NEXT 1000 MAXEXTENTS 20 PCTINCREASE 0) 


CREATE DATABASE, CREATE ROLLBACK SEGMENT, and CREATE 
TABLESPACE statements; Storage clause. 
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NTE VRE 
ALTER SEQUENCE 


Purpose Change SEQUENCE options in one or more of the following ways: 


* change the future increment between numbers in a sequence 
* set the MINVALUE or MAXVALUE or turn one or both off 
* turn CACHE on or off 

* turn ORDER on or off 


Prerequisites You must be the owner of the sequence or have ALTER privilege on the 
sequence or have DBA privilege. 


Syntax ALTER SEQUENCE [user.]sequence 
[INCREMENT BY integer] 
[MAXVALUE integer | NOMAXVALUE] 
[MINVALUE integer | NOMINVALUE] 
[CYCLE | NOCYCLE] 
[CACHE integer | NOCACHE] 
{ORDER | NOORDER]} 


Keywords and user is the username of the sequence owner. 
Parameters sequence is the name of an existing sequence. 

INCREMENT BY _ specifies the increment used for future sequence 
integer numbers. 
MAXVALUE | specifies a new maximum sequence number or 
NOMAXVALUE makes the maximum sequence number unlimited. 
MINVALJUE | specifies a new minimum sequence number or 
NOMINVALUE _ makes the minimum sequence number unlimited. 
CYCLE | determines if the sequence wraps around to 
NOCYCLE MINVALUE after reaching MAXVALUE (for 


ascending sequences) or if the sequence wraps 
around to MAXVALUE after reaching 
MINVALUE (for descending sequences). 


CACHE integer |__ controls whether or not ORACLE stores future 

NOCACHE sequence numbers in memory for faster access. 
The default cache is 20. CACHE must be smaller 
than the difference between MAXVALUE and 


MINVALUE. 
ORDER | determines whether or not ORACLE generates 
NOORDER sequence numbers in order of request. Normally, 
such generation will occur without actually 
specifying ORDER. 
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Usage Notes 


Examples 


Related Topics 


ALTER SEQUENCE 


‘The sequence must be dropped and recreated in order to restart the 
sequence at a different number. Only future sequence numbers are 
affected by the ALTER SEQUENCE statement. 


Some validations are performed. For example, anew MAXVALUE 
cannot be imposed which is less than the current sequence number. 


To set a new maximum value for the ESEQ sequence, enter: 
ALTER SEQUENCE ESEQ MAXVALUE 1500 

To turn CYCLE and CACHE on, enter: 

ALTER SEQUENCE ESEQ CYCLE CACHE 5 

CREATE SEQUENCE and DROP SEQUENCE statements. 


SQL Statement Reference 


5- 


15 





SEE 
ALTER SESSION 


5-16 


Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Alters your current session enabling or disabling the SQL trace facility. 
None. 


ALTER SESSION 
SET SQL_TRACE {TRUE|FALSE} 


TRUE enables the SQL trace facility 
FALSE disables the SQL trace facility 


The SQL trace facility generates performance statistics for the 
processing of SQL statements. To enable the SQL trace facility for the 
SQL statements in your session, issue the ALTER SESSION statement 
with the TRUE keyword. To disable the SQL trace facility for your 
session, issue the ALTER SESSION statement with the FALSE keyword. 
You can enable the SQL trace facility for all sessions on an ORACLE 
instance by setting the value of the INIT.ORA parameter SQL_TRACE 
to TRUE. In this case, you can disable the SQL trace facility for an 
individual session by issuing the ALTER SESSION statement with the 
FALSE keyword. 


Do not issue the ALTER SESSION statement from SQL*Forms triggers. 
For information on enabling and disabling the SQL trace facility from 
SQL*Forms, refer to Chapter 23 "Components" and Chapter 26 
"Options" of the SQL*Forms Designer's Reference. 


For more information on the SQL trace facility, including how to 
format and interpret its output, refer to Chapter 7 "Performance 
Diagnostic Tools" of the ORACLE RDBMS Performance Tuning Guide. 


To enable the SQL trace facility for your session, issue the statement: 

ALTER SESSION SET SQL_TRACE TRUE 

To disable the SQL trace facility for your session, issue the statement: | 
ALTER SESSION SET SQL_TRACE FALSE 


Chapter 7 "Performance Diagnostic Tools" of the ORACLE RDBMS 
Performance Tuning Guide. 
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ALTER TABLE 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Alter the definition of a table by: 
+ adding columns or constraints 
+ modifying column definitions (such as datatypes or NOT 
NULL) 
« dropping constraints 
+ modifying future storage allocations 
+ recording that a BACKUP has taken place for the table 


You must own the table, have been granted ALTER privilege on the 
table, or have DBA privilege. 


ALTER TABLE [user.] table , 
(ADD { {column_element | table_constraint} 
(, {column_element | table_constraint} Jace bol 
[MODIFY (column_element le column_element] veoh 


[DROP CONSTRAINT constraint] ... 
[PCTFREE integer] [PCTUSED integer] 
(INITRANS integer] [MAXTRANS integer] 
[STORAGE storage] 

[BACKUP } 


[user.]table is the owner and tablename of the existing table 
you want to alter. The user defaults to the user 
issuing the ALTER TABLE statement. To alter a 
table you do not own, you must have ALTER 
privilege on the table or DBA privilege. 


ADD/MODIFY adds or modifies a column definition, column 
column_element constraint, column default. Refer to the syntax 

description of column_element later in this chapter. 
ADD adds.a table constraint. Refer to Constraint clause 
table_constraint later in this chapter. 


DROP constraint drops the specified column or table constraint. 


PCTEREE integer (Refer to the PCTFREE, PCTUSED, INITRANS, 
PCTUSED integer and MAXTRANS parameters of the CREATE 
INITRANS integer TABLE statement later in this chapter.) 


MAXTRANS integer 
STORAGE storage (Refer to the Storage clause later in this chapter.) 


BACKUP updates the Data Dictionary to indicate that the 
table has been backed up as of the time of the 
ALTER TABLE statement. 
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Usage Notes 


Examples 


Related Topics 


If you use the ADD clause to add a new column to the table, then the 
initial value of each row for the new column is NULL. You can only 
add a NOT NULL column to a table that contains no rows. 


You can use the MODIFY clause to change any of these attributes of a 
column: 


* size 


* datatype 
« NOTNULL 


You can change a column's datatype or decrease a column’s size only if 
the column has null values in all rows. You can make an existing 
column NOT NULL only if it contains no null values. If you change 
the length of a NOT NULL column and you do not specify NOT 
NULL in the MODIFY clause, the column remains NOT NULL. 


Note: For a view defined with a query that selects all columns 
(“SELECT * FROM..."), the view will no longer work correctly if 
columns are added to a table to which the view refers. This may be 
fixed by dropping and re-creating the view. 


To add a number column named THRIFTPLAN to a table named EMP, 
with a maximum of seven digits and two decimal places, as well asa 
one-character column called LOANCODE, enter: 
ALTER TABLE EMP 

ADD (THRIFITPLAN NUMBER(7,2), LOANCODE CHAR (1)) 
To increase the size of THRIFIPLAN to nine digits and drop the 
ENAME_CNSTR constraint, enter: 
ALTER TABLE EMP 


MODIFY (THRIFTPLAN NUMBER (9,2) ) 
DROP CONSTRAINT ENAME_CNSTR 


CREATE TABLE statement; Constraint clause. 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Alter an existing tablespace by: 


+ adding or renaming database file(s) 

* changing default table space storage parameters 
* taking the tablespace online or offline 

« starting or stopping backup 


Requires DBA privilege. 
ALTER TABLESPACE tablespace 
{ADD DATAFILE filespec [,filespec] -.+ 
|RENAME DATAPILE ‘filename’ [,° filename’] ... 
TO ‘filename’ [,’filename’] ... 
{DEFAULT STORAGE storage 
|ONLINE 
JOPFLINE [NORMAL] IMMEDIATE] 
| (BEGIN |END} BACKUP} 
tablespace is the name of an existing tablespace. 
ADDDATAFILE makes additional space available to the tablespace. 
filespec You may add a file to a tablespace while it is online 
or offline. filespec is a specification of a database file 
in the form: 
‘filename’ [SIZE integer [KiM)] [REUSE] 
integer specifies a SIZE in a number of bytes. No 
integer means ORACLE will use the default 
tablespace size of 10M. If the integer is followed by 
K, then SIZE is oot? as the integer multiplied 
by 1024. If M is used, then SIZE will be the integer 
multiplied by 1048576. 
If SIZE is specified and REUSE is omitted, the file 
is to be created with the specified size and must 
not already exist. If both SIZE and REUSE are 
specified, the file should be created if it does not 
exist, but if it exists the size is to be checked. The 
use of REUSE alone or no options indicates that the 
file must already exist and should be used as is. 
RENAME renames one or more files associated with the 
DATAFILE tablespace. Does not rename the operating system 
filename file associated with the tablespace file. The 
TO filename tablespace should be offline during the rename. 
DEFAULT specifies the new default storage for future 
STORAGE storage objects created in the tablespace. Refer to the 


Storage clause later in this chapter. 
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Usage Notes 


Examples 


Related Topics 


ONLINE signifies that the tablespace should be brought 
back online. 
OFFLINE signifies that the tablespace should be taken 


offline, either IMMEDIATEly or after all current 
users are no longer accessing the named tablespace 
(NORMAL). 


BEGIN BACKUP _ signifies that the database files that comprise this 
tablespace will be backed up with a system backup 
procedure. This statement has no effect on access 
to tablespace; users can continue to access it. This 
statement is necessary for control file and redo log 
record keeping. 


END BACKUP signifies that the system backup procedure has 
completed. 
Rename a data file(s) with the following steps: 
1. Take the tablespace offline. 
2. Rename the file(s) at the operating system level. 


3, Rename the database file(s) with the ALTER TABLESPACE 
statement. 


4. Bring the tablespace back online. 


To signal to the database that a backup is about to begin, enter: 
ALTER TABLESPACE ACCOUNTING BEGIN BACKUP 

To signal to the database that the backup is finished, enter: 

ALTER TABLESPACE ACCOUNTING END BACKUP 

Note that you may also backup a tablespace while it is online. An 
offline backup does not require that you archive redo logs. 


CREATE TABLESPACE, CREATE DATABASE, and DROP 
TABLESPACE statements; Storage clause 
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ALTER USER 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Alter any of the following characteristics of an existing database user: 


* password 

+ default tablespace for object creation 

+ default temporary tablespace for temporary segments created 
on behalf of the user 


Requires DBA privilege. 
ALTER USER username [IDENTIFIED BY password] 


(DEFAULT TABLESPACE tablespace] 
[TEMPORARY TABLESPACE tablespace] 


username is the currently valid username for a database user. 
password is the new password for the specified username. 
DEFAULT specifies the default tablespace for object creation. 
TABLESPACE 


TEMPORARY specifies the default tablespace for the creation of 
TABLESPACE temporary segments. 


A.user’s password may also be changed with the GRANT statement. 
Auser’s default tablespace is also set when a user is granted resource to 
a tablespace and that tablespace is the first tablespace to which the user 
has been granted resource. The default temporary tablespace will also 
be set to the first tablespace granted to a user. 


To change username SCOTT’s password to LION and change his 
default tablespace for the creation of database objects to an existing 
tablespace named TSTEST, enter: 

ALTER USER SCOTT 


IDENTIFIED BY LION 
DEFAULT TABLESPACE TSTEST 


CREATE TABLESPACE and GRANT statements. 
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Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Select auditing options for database access. 


Requires DBA privilege. 
AUDIT {system_option [,system_option]... | ALL } 
(WHENEVER [NOT] SUCCESSFUL] 

system_option is one of DBA, CONNECT, RESOURCE, or NOT 
EXISTS. 

ALL is equivalent to a list of all the system_options. 
By default, statements are audited whether or not 
they are successful. 

WHENEVER indicates that SQL statements are audited only if 


SUCCESSFUL they complete successfully. 


WHENEVER NOT indicates that SQL statements are audited only 
SUCCESSFUL when they fail. 


This form of auditing allows the DBA to track actions resulting from: 

* connection to or disconnection from the database (CONNECT 
system option) 
statements requiring RESOURCE privilege (RESOURCE 
system option) such as the creation of database objects 


* statements requiring DBA privilege (DBA system option) 


* statements resulting in ORACLE errors because a specified 
database object does not exist (NOT EXISTS system option): 


Auditing is enabled system-wide via the INIT.ORA parameter 
AUDIT_TRAIL. The AUDIT statements execute successfully regardless 
of whether auditing is enabled. If auditing is enabled, rows are written 
to the audit trail. If not, no rows are written. 


All forms of auditing place the audit results into data dictionary tables. 
Asa result, you may easily generate reports based on the audit data 
dictionary tables. As the audit data dictionary tables grow, you may 
also archive old audit records (and then delete these same records). 
You should never drop the audit data dictionary tables themselves. 
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Examples 


Related Topic 


AUDIT (Form I) 


Note that for DDL and DML statements, the term "completion" means 
the completion of the operation’s "parse phase" (parse, dictionary 
lookup, security check), which is not precisely the same as its 
"execution", Note also that a rollback will not delete the row in 

the audit trail. 


Tf neither WHENEVER SUCCESSFUL nor WHENEVER NOT 
SUCCESSFUL is specified, then the SQL statements are audited 
regardless of success or failure. 


To audit all successful resource requests, enter: 

AUDIT RESOURCE WHENEVER SUCCESSFUL 

To audit all unsuccessful attempts to access the database, enter: 
AUDIT CONNECT WHENEVER NOT SUCCESSFUL 

AUDIT Form II and NOAUDIT statements. 
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AUDIT (Form ID 


Purpose Enable auditing of access to database objects such as tables and views. 


Prerequisites Requires that you own the object to be audited or requires DBA 
privilege. The DEFAULT option requires DBA privilege. 


Syntax AUDIT {table option {,table_option]... | ALL} 
ON { [user.jtable | DEFAULT} 
[BY {SESSION | ACCESS}] 
(WHENEVER [NOT] SUCCESSFUL} 





Keywords and _ table_option 
Parameters 


ALL 
user 
table 


DEFAULT 


BY SESSION 


BY ACCESS 
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For tables, the applicable options are ALTER, 
AUDIT, COMMENT, DELETE, GRANT, INDEX, 
INSERT, LOCK, RENAME, SELECT, or UPDATE. 


For views, the applicable options are AUDIT, 
COMMENT, INSERT, DELETE, GRANT, LOCK, 
RENAME, SELECT, and UPDATE. 


For sequences, the applicable options are ALTER, 
AUDIT, GRANT, and SELECT. 


For synonyms, the applicable options are the same 
set of options for tables (since all the actions 
actually affect a base table). 


can be used to indicate all applicable options. 
is the username of the table owner. 


is the name of a view, table, sequence, or a 
synonym denoting a view or table. 


specifies that all tables created subsequently will 
be audited as specified by the table_option list 
(sets default system-wide auditing options). 
DEFAULT does not apply to views or sequences. 


specifies that only one audit record per type of 
audit access be generated for the duration of the 
user’s session. 


specifies that one audit record per access per type 
of audit access be generated. 





Usage Notes 


Example 


Related Topics 


AUDIT (Form ID) 


The BY clause determines the granularity of the audit by specifying 
how often rows are written to AUDIT_TRAIL. BY SESSION will 

record that a certain type of access was made to the database object. BY 
ACCESS will record that the access was made and as well as how often. 


Some events happen much more frequently than others (for example, 
DML statements normally occur more often than GRANTS). The more 
detailed the auditing, the more audit records generated, so you should 
consider which statements are most important to audit. 


In BY SESSION mode, a table has at most one session record in 
AUDIT_TRAIL per user session. Selected SQL statements are recorded 
by updating the row in AUDIT_TRAIL. The rows record how many 
times the selected statements executed successfully or unsuccessfully. 
No BY clause is equivalent to BY SESSION. 


In BY ACCESS mode, selected SQL statements are recorded by inserting 
rows in AUDIT_TRAIL. For a DML operation, rows are written or 
updated at the completion of the operation’s "parse phase." 


To audit all sessions in which unsuccessful attempts occur to access the 


EMP table, enter: 
AUDIT ALL ON EMP WHENEVER NOT SUCCESSFUL 


To audit every individual attempted INSERT or UPDATE on the EMP 
table, enter: 


AUDIT INSERT, UPDATE ON EMP BY ACCESS 
AUDIT Form I and NOAUDIT statements. 
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Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Releases resources allocated by an OPEN cursor statement. 
Must name a previously OPENed cursor. 


EXEC SQL CLOSE cursor_name 


cursor_name is a previously OPENed cursor. 


Attempting to CLOSE a cursor which is not currently OPEN will 
generate an error. A cursor does not have to be CLOSEd to be 
re-OPENED. Rows cannot be FETCHed from a CLOSEd cursor. 


Closing a cursor deallocates a previously OPENed explicit cursor. The 
deallocation does not occur, however, until the memory associated 
with the cursor is required by another explicit cursor. This deallocation 
is performed automatically by ORACLE. 

The HOLD_CURSOR and RELEASE_CURSOR precompiler options 
alter the effect of the CLOSE cursor statement. For information on 


HOLD_CURSOR and RELEASE_CURSOR, refer to the Programmer's 
Guide to the ORACLE Precompilers manual. 


The example that follows shows the typical sequence when using 
cursors. You must declare the cursor, open the cursor, fetch, and 
finally, close the cursor: 


EXEC SQL DECLARE ¢c CURSOR 
FOR SELECT ename, empno, job, sal 
FROM emp 
WHERE deptno=:deptno; 


EXEC SQL OPEN ¢; 


example: loop 
EXEC SQL FETCH c INTO :ename, :empno, :job, :sal:sal_ind; 


if sqlca.sqlcode = oracle.error.not_found then 
exit example; 
end if; 


end loop example; 


EXEC SQL CLOSE ¢; 
PREPARE, DECLARE CURSOR, and OPEN cursor statements. 
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Column Constraint 
Refer to the Constraint clause later in this chapter. 
BC SE NED ST 
Column Element 
Purpose Define a column and associated column constraints. 
Prerequisites None. 
Syntax column datatype [DEFAULT expr] [column constraint] 
Keywords and column follows the convention for naming database objects 
Parameters and is the name of the intended column. 
datatype is a valid datatype as defined in Chapter 3 
"Elements of the SQL Language" of this Manual. 
DEFAULT expr The optional DEFAULT clause specifies an 
expression to be assigned to the column ifa 
value is not explicitly assigned when a row is 
inserted into the table. All expressions are valid 
except those that refer to a column, LEVEL, or 
ROWNUM. The datatype of the expression must 
match the datatype of the column. Refer also to 
the syntax description of expr in Chapter 4 
"Operators and Functions” of this Manual. 
column constraint (Refer to the Constraint clause later in this chapter.) 
Usage Notes ORACLE Version 6.0 supports the syntax of the DEFAULT clause; 
semantic support will be provided in a future version. 
Column elements are used in the CREATE TABLE and ALTER TABLE 
commands to specify column definitions for a table. 
Examples To create a column named EMPNO, of datatype NUMBER, width 5 
and NOT NULL, enter: ; 
CREATE TABLE EMP (EMPNO NUMBER(5) NOT NULL, ... ) 
To create a column named DEPTNO, of datatype NUMBER, width 5 
and default value 100, enter: 
CREATE TABLE EMP (..., DEPTNO NUMBER(S) DEFAULT 100) 
Related Topics Constraint clause; CREATE TABLE statement. 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Insert a comment about a table or column into the Data Dictionary. 


Must be the owner of the table, have DBA privilege or have been 
granted ALTER privilege on the table to comment the table or columns 
within the table. 


COMMENT ON { TABLE [user.]table 
{ COLUMN [user.]table.column } 
Is ‘text’ 


user is the owner of the table. 


TABLE table specifies the name of the table or view to be 
commented. 


COLUMN column _ specifies the name of the column to be commented. 
text is any quoted, valid character string up to 255 
bytes. Refer to the syntax description of text in 


Chapter 3 "Elements of the SQL Language” in this 
Manual. 


You can effectively drop a comment from the database by setting it to 
the empty string”. To see the comment, select the COMMENTS 
column from one of the Data Dictionary views: 
ALL_COL_COMMENTS, ALL_TAB_COMMENTS, 
USER_COL_COMMENTS or USER_TAB_ 

COMMENTS. 


To insert an explanatory remark on a column named NOTES in a table 
named SHIPPING, you might enter: 


COMMENT ON COLUMN SHIPPING.NOTES 
IS 'Special packing or shipping instructions’ 


To drop this comment from the database, you would enter: 
COMMENT ON COLUMN SHIPPING.NOTES Is ’! 
/**/ (SQL comment). 
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COMMIT 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Transactions 


Use the COMMIT statement to: 


* make "permanent" all changes performed in the current 
transaction (naturally, the data may be changed by future 
updates) 

* erase all savepoints in that transaction 

* end the transaction 

* release the transaction’s locks 


None. 


COMMIT [WORK] 


WORK is optional and is provided for ANSI compatibility. 
The COMMIT and COMMIT WORK statements 
are equivalent. 


The recommended practice is to explicitly end transactions in 
application programs using the COMMIT WORK (or ROLLBACK 
WORK) statement, including the last transaction before disconnecting 
from ORACLE. If you do not explicitly commit the transaction and the 
program terminates abnormally, the last uncommitted transaction will 
be rolled back. 


A normal exit from most ORACLE utilities and tools will cause the 
current transaction to be committed. A normal exit from an ORACLE 
Precompiler program will not commit the transaction and will rely on 
ORACLE to rollback the current transaction. Refer to the embedded 
SQL COMMIT statement later in this chapter. 


A transaction ( or a logical unit of work) is a sequence of SQL statements 
that ORACLE treats as a single unit. A transaction begins with the first 
executable SQL statement after a COMMIT, ROLLBACK or connection 
to the database. A transaction ends with a COMMIT, ROLLBACK or 
disconnection (intentional or unintentional) from the database. Note 
that ORACLE issues an implicit COMMIT before and after any DDL. 
SQL statement. For a complete description of transactions and 
transaction processing, refer to Chapter 11 "Transaction Control" of the 
ORACLE RDBMS Database Administrator's Guide . 


A COMMIT or ROLLBACK statement will also terminate a READ 
ONLY transaction begun by a SET TRANSACTION statement. 
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COMMIT 
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Example To insert a row into the DEPT table and commit this change, enter: 


INSERT INTO DEPT VALUES ('50’,’MARKETING’ ,’ TAMPA’) 
COMMIT WORK 


Related Topic ROLLBACK, SAVEPOINT and SET TRANSACTION statements. 
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Purpose 


Prerequisites 


Syntax 


Keyword and 
Parameters 


Usage Notes 


Example 
Related Topics 


SRA 
COMMIT (Embedded SQL) 


Make permanent any changes that were made in the current 
transaction. The RELEASE option of the COMMIT is used to release 
resources and disconnect from the database. 


None. 


EXEC SQL [AT dbname] COMMIT [WORK] [RELEASE] 


AT dbname is an optional clause indicating the name of the 
database where the COMMIT should be issued. 
For additional information on the AT clause, refer 
to the DECLARE DATABASE statement later in 
this chapter. 

RELEASE is an optional parameter that disconnects you from 
the database. 


Always explicitly commit or rollback the last unit of work in a program 
by using the COMMIT statement and its RELEASE option. If you do 
not COMMIT and RELEASE, then locks obtained during the program 
will be held after program termination until the ORACLE recognizes 
that the process is no longer active. This may cause other users ina 
multi-user environment to wait for, or fail to obtain, the locked 
resources. 

If you issue a COMMIT without the RELEASE clause, your current 
transaction is committed without disconnecting you from the database. 


ORACLE automatically rolls back changes if the program terminates 
abnormally. 


The COMMIT WORK statement has no effect on the contents of the 
host variables or on the control flow of the program. 


EXEC SQL COMMIT RELEASE 
ROLLBACK, SAVEPOINT, and SET TRANSACTION statements. 
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Purpose 


Prerequisites 


Syntax 


Keyword and 
Parameters 


Usage Notes 


Provide a direct connection to the ORACLE RDBMS. A program must 
connect to the database before it can access any data. The CONNECT 
is used to connect the user to any ORACLE database. 


Must have the CONNECT privilege to the specified database. 


EXEC SQL CONNECT ruser_ password 
{AT dbname] 
(USING :dbstring] 


or 


EXEC SQL CONNECT :user IDENTIFIED BY rpassword 
[AT dbname} 
[USING :dbstring} 


suser_password is a single host variable containing the user’s 
ORACLE username and password separated by a 
forward slash "/". 


For automatic login set suser_password to "/". 
This indicates to ORACLE that the user’s operating 
system username should be used to connect to 


ORACLE. 
:user IDENTIFIED allows the username and password to be passed as 
BY :password two separate items. 
AT dbname is an optional clause introducing the name of a 


non-default database. The database name must 
first be defined in the DECLARE DATABASE 


statement. 
USING specifies the SQL*Net database specification string 
sconnect_string used to connect to a remote database. 


If the AT clause is not specified, then the database referenced in the 
USING clause is the default database. 


A program can have multiple CONNECTs, but can only CONNECT 
once (implicitly specifying the default database) without using the AT 
clause to specify a remote database. 


If you omit the USING clause, the CONNECT statement connects you 
to the default database. 
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Direct Connect via 
SQL*Net 


CONNECT (Embedded SQL) 


A direct connection requires you to establish a separate connection to 
each node and to access data in any way you desire by using a cursor 
that is opened on that remote database. When using this method, you 
connect to the remote database directly, giving the connection a name 
that is referenced in other EXEC SQL statements. The following 
example shows such a usage: 


userid := "scott" 
password := "tiger" 
connect string := "D:HOVMS" 


EXEC SQL DECLARE dbname DATABASE; 


EXEC SQL CONNECT suserid 
IDENTIFIED BY password 
AT dbname 
USING :connect_string; 


Subsequent SQL statements using the AT clause that includes the name 
dbname will be executed at the database identified by dbname. (Note 
that dbname is not a host variable and its value cannot be changed at 
runtime; it must be a valid SQL identifier). connect_string might contain 
a SQL*Net string specifying a connection to a remote node named 
MYNODE, for example, using the DECnet protocol: D:MYNODE. For 
a full description of the syntax required for connect_string, refer to the 
SQL*Net User’s Guide for your specific SQL*Net protocol. 


When using this method, you might perform the following sequence: 
EXEC SQL AT remote_db SELECT...7 

EXEC SQL AT remote db INSERT ...; 

EXEC SQL AT remote_db DECLARE cursor_name CURSOR FOR SELECT...; 
EXEC SQL OPEN cursor_name...? 

EXEC SQL FETCH cursor_name...7 

Note that when opening or fetching from the cursor, you do not use the 
AT clause again. The SQL statement will be executed at the database 


referenced in the AT clause of the associated DECLARE cursor 
statement. 


When using this technique, you can do anything for which you have 
been given the privileges to do at the remote database, including 
UPDATEs. You may also maintain multiple transactions, one for each 
database that you are connected to. 
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CONNECT (Embedded SQL) 
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Example 


Indirect Connection 
via SQL*Net 


Related Topics 


The following statement uses the SQL*Net DECnet protocol to connect 
the user to a remote database named NYC previously identified with 
the DECLARE DATABASE statement: 
EXEC SQL CONNECT :username 

IDENTIFIED BY :password 

AT NYC 

USING D:NYC_NODE 
The application initialized both the :username and :password host 
variables with a valid ORACLE username and password pair before 
submitting the preceding CONNECT statement. 


An alternate way for a precompiled program to access remote data 
is to rely on the distributed query facility provided by the ORACLE 
RDBMS. In this case, you connect to one database, the local database, 


and it in turn connects you to the another database, the remote database. 


You effectively hand SQL statements to one ORACLE database, which 
decomposes the query into parts and fetches the data from another 
database. 


See the CREATE DATABASE LINK statement for a comprehensive 
discussion of how to create and use database links. 


Note that the database link is not at all related to the database name 
used in the precompiler AT clause. The database link is used within the 
SQL statement after a table name. In contrast, the precompiler database 
name is used only in the AT clause of an EXEC SQL statement to 
indicate where the SQL statement should be executed. 


Note also that database links only permit the execution of SELECT 
statements against remote nodes. 


COMMIT RELEASE and DECLARE DATABASE statements. 
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Constraint clause 
Purpose 


Prerequisites 


Syntax 
Table Constraint 


Syntax 
Column Constraint 


Restrict the range of valid values for a column or a group of columns. 
AILINSERT, UPDATE and DELETE statements cause the evaluation of 
relevant constraints. The constraint must be satisfied for the statement 
to succeed. 


Currently ORACLE Version 6.0 supports the syntax of constraints, and 
stores all constraint definitions in the Data Dictionary. This version 
does not actually enforce constraint definitions (NOT NULL is 
currently supported). 


Use constraints to impose one or more of the following rules ona 
column or a group of columns: 


* require that a column or group of columns contain a value that 
is NOT NULL 


* require the value of a column or group of columns to be 
UNIQUE within the table 


* identify a column or group of columns as the PRIMARY KEY 


* require the value of a column or group of columns to exist in 
another table (FOREIGN KEY) 


* require the value of a column or group of columns to conform 
to an expression (CHECK) 


Must be used in a column_element or table_constraint of the CREATE 
TABLE or ALTER TABLE statements. The CREATE TABLE statement 
requires RESOURCE privilege. 


{UNIQUE | PRIMARY KEY) (column [,column]... ) 
[CONSTRAINT constraint] ] 

FOREIGN KEY (column [,column]... ) 
REFERENCES [user.]table ((column [,column]... )] 
[CONSTRAINT constraint]] 

(CHECK (condition) [CONSTRAINT constraint] ] 


Column [NULL] | (NOT NULL [ CONSTRAINT constraint ] J 

{ UNIQUE | PRIMARY KEY } [ CONSTRAINT constraint ] } 

REFERENCES [ user. ] table [ ( column ) ] 
(CONSTRAINT constraint) ] 

CHECK { condition ) [ CONSTRAINT constraint} ] 
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Constraint clause 


Keywords and 
Parameters 


Usage Notes 


Column specifies the name of the column to which the 
constraint should apply. 


CONSTRAINT specifies the name of the constraint. This optional 


constraint clause applies to all constraints. 

NULL! specifies if a column may or may not contain null 
NOT NULL values. 

UNIQUE forces values of a column to be unique. 


PRIMARY KEY identifies the column as the primary key. 


FOREIGN KEY identifies the column(s) as a foreign key of user.table 
(column...) (column(s)). The default column(s) is/are the 
REFERENCES primary key of the table. 

user.table (column...) 


CHECK condition specifies a condition that the column must satisfy 
for the row to exist in the table. Refer to the syntax 
definition of condition in Chapter 4 "Operators and 
Functions" of this Manual. 


There are two types of constraints, fable constraints and column 
constraints. They are identical except that a column constraint 
references a single column whereas a table constraint may reference 
one or more columns. 


Constraints may be specified in two ways: 


+ Table constraint definitions are part of the global table definition 
asin: 
CREATE TABLE Project_Employee 
(PROJECT NUMBER, 


EMPLOYEE NUMBER, 
PRIMARY KEY (PROJECT, EMPLOYEE) ) 


* Column constraints are local to a specific column as in: 


CREATE TABLE DEPT 
(DEPTNO NUMBER PRIMARY KEY, ..-) 


As with other database objects, constraints are recorded in the Data 
Dictionary. 


You have the option of naming the constraint. If you do not name the 
constraint, the constraint will be assigned a name in form of SYS_Cn, 
where n is an integer that makes the constraint unique within the 
database. System-assigned constraint names are reassigned during 
import. 
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NULL 


Example 


UNIQUE 


Example 


Constraint clause 


Constraints must be used in either the CREATE TABLE or ALTER 
TABLE statements. Constraints may be added to or dropped froma 
table with the ALTER TABLE statement. To modify a constraint, you 
must drop it and then add it. 


The NULL constraint may only be used in a column constraint. 


A NULL constraint may be either NULL or NOT NULL. NULL means 
that the column may be null for any row of the table. Conversely, every 
row must have a value for any column that is NOT NULL. If omitted, a 
column’s NULL constraint defaults to NULL, permitting a column to 
contain nulls. 


To include a column named EMPNO of NUMBER datatype with a 
NOT NULL constraint named NN_CNSTRNT in a CREATE TABLE 
statement, enter: 


CREATE TABLE EMP 


(EMPNO NUMBER(S) NOT NULL CONSTRAINT NN_CNSTRNT ... ) 
The UNIQUE constraint: 
* requires that each row in the table have a distinct value for the 
column 


* requires that each column be declared NOT NULL 
* requires that the column not be a PRIMARY KEY 


To include a column name ENAME of CHAR datatype with a UNIQUE 
constraint named UNQ_NAME ina CREATE TABLE statement, enter: 
CREATE TABLE EMP ( ... 


ENAME CHAR(9) UNIQUE CONSTRAINT UNQ_NAME 
wee) 


To add an area code and a telephone column to the EMP table and 
identify these columns as UNIQUE (table constraint syntax), enter: 


ALTER TABLE EMP 
ADD (PHONE_AREA_CODE CHAR(3) NOT NULL, 
PHONE_NUMBER CHAR(8) NOT NULL, 
UNIQUE (PHONE_AREA_CODE,PHONE_NUMBER) 
CONSTRAINT PHONE_CNSTR) 
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PRIMARY KEY 


Example 


FOREIGN KEY/ 
REFERENCES 


A PRIMARY KEY: 


+ is used to uniquely identify each row ina table 


* isa superset of the UNIQUE requirements and as such requires 
that a column be declared NOT NULL 

* requires that the column not have the UNIQUE constraint 

* may be specified only once per table, although a primary key 
may be composed of multiple columns. If your primary key is 
one column, you may use either a column constraint or a table 
constraint. If your primary key contains more than one 
column, you must use a table constraint. 


To include a column named EMPNO of NUMBER datatype with a 
PRIMARY KEY column constraint named PK_CNSTRNT in a CREATE 
TABLE statement, enter: 
CREATE TABLE EMP 

(EMPNO NUMBER (5) PRIMARY KEY CONSTRAINT PK_CNSTRNT, 

“) 

To create a table relating ships to containers, and to identify the 
SHIP_NO and CONTAINER_NO as the primary key, enter: 
CREATE TABLE SHIP_CONTAINER 

(SHIP_NO NUMBER NOT NULL, 


CONTAINER_NO NUMBER NOT NULL, 
PRIMARY KEY (SHIP_NO, CONTAINER_NO)) 


The table that contains the REFERENCES constraint values is called the 
foreign key table. The table that is referred to by the REFERENCES 
constraint is called the primary key table. In the following discussion, the 
EMP table is the foreign key table and the DEPT table is the primary 
key table. 
The FOREIGN KEY/REFERENCES constraint: 

+ implements the concept of a foreign key as described in Chapter 
1 "The Relational Model” of this Manual 
will reject a INSERT or UPDATE of a value if a corresponding 
value does not currently exist in the primary key table 
will reject a DELETE if it would invalidate a REFERENCES 
constraint. For example, a department may not be removed 


from the DEPT table if there are any employees from the EMP 
table that belong to that department 
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Constraint clause 


* must reference a PRIMARY KEY or UNIQUE column or group 
of columns in the primary key table 

+ will reference the PRIMARY KEY of the primary key table if no 
column or group of columns is specified in the constraint 

* must reference a TABLE, not a VIEW or a CLUSTER 

requires that you own the primary key table, have 

REFERENCE privilege on the primary key table, or have 

column-level REFERENCE privilege on the referenced 

column(s) in the primary key table. 

* places no restrictions on how other constraints might reference 
the same tables or columns. Thus, a column may be referenced 
multiple times 

* requires that the datatypes of the foreign key column(s) and 
constraints column(s) match (the names need not match). 

+ may reference the same table named in the CREATE TABLE 
statement. 


* must not refer to same column more than once (although a 
single column may be referenced by multiple foreign key 
constraints). 


When used ina table constraint, the FOREIGN KEY (column [,column...]) 
syntax must be added before the REFERENCES keyword. 


Ifa REFERENCES column list is not supplied for a FOREIGN KEY 
constraint, then the columns are assumed to be the PRIMARY KEY of 
the REFERENCES table. 


Table and column constraint information is stored in the 
CONSTRAINT_DEFS and the CONSTRAINT_COLUMNS data 
dictionary table. 
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Example 


CHECK 


Example 


If the DEPTNO column is considered a foreign key column in the EMP 
table, an employee may not be inserted into the EMP table unless the 
employee’s DEPTNO is null (assuming that the DEPTNO permits 
nulls) or matches one of the DEPTNOs in the DEPT table. The 
following example illustrates the portions of the CREATE TABLE 
statement needed to create a foreign key named DEPTNO that 
references the DEPTNO column of the DEPT table: 
CREATE TABLE EMP 
Caaad 
deptno NUMBER REFERENCES scott.dept ( deptno ) 
CONSTRAINT deptno_fk, 
-) 
To add a SHIP_NO and a CONTAINER, NO column to the ORDERS 
table, and to identify these columns as referencing BLAKE’s 
SHIP_CONTAINER table (using the table constraint syntax), enter: 
ALTER TABLE ORDERS 
ADD (SHIP_NO NUMBER NOT NULL, 
CONTAINER_NO NUMBER NOT NULL, 


FOREIGN KEY (SHIP_NO, CONTAINER_NO) 
REFERENCES BLAKE.SHIP_CONTAINER CONSTRAINT ORDERS_FK) 


The CHECK constraint syntax is identical for both column and table 
constraints. A CHECK constraint may only refer to columns in the 
same table. Within a column constraint, the condition may not refer to 
a column other than the column to which the constraint belongs. A 
table CHECK constraint may refer to multiple columns. 


CREATE TABLE dept 
(deptno NUMBER CHECK (deptno between 10 and 99), 
dname CHAR(9) CHECK (dname = upper (dname)), 
loc CHAR(10) CHECK (loc in (’DALLAS’,’BOSTON’,’NEW YORK'))) 


The first CHECK insures that the department number is between 10 
and 99. The second checks that all department names are entered in 


uppercase. The third verifies that department locations are one of 
DALLAS, BOSTON, or NEW YORK. 


To add a table constraint that specifies that the total of salary and 
commission not exceed $5000, enter: 


ALTER TABLE EMP 
ADD (CHECK (SAL+COMM 5000)) 
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Additional Table 
Constraint Examples 


Related Topics 


Constraint clause 


The following CREATE TABLE statement uses one PRIMARY KEY 
table constraint, two FOREIGN KEY table constraints and two CHECK 
table constraints: 
CREATE TABLE order detail 
(order_id NUMBER, 
part_number NUMBER, 
PRIMARY KEY (order_id, part_number) CONSTRAINT oid_pno_pk, 
FOREIGN KEY (order_id) 
REFERENCES scott.order (order_id) CONSTRAINT oid_fk, 
FOREIGN KEY (part_number) 
REFERENCES scott.part (part number) CONSTRAINT pno_fk, 
CHECK (order_id > 0) CONSTRAINT oid_ck, 
CHECK (part number > 0) CONSTRAINT pno_ck 
estes +, 


. The primary key of the ORDER_DETAIL table is a combination of 
ORDER_ID and PART_NUMBER. 


2. ORDER_ID is a foreign key from the ORDER table and 
PART_NUMBER is a foreign key from the PART table. 


3. Neither ORDER_ID nor PART_NUMBER may be null in the 
ORDER_DETAIL table because they comprise the primary key. 
(This is implied by the PRIMARY KEY constraint, and thus NOT 
NULL need not be specified for either column individually). 


a 


4, Because they are both foreign keys, a row may not be inserted into 
ORDER_DETAIL unless the ORDER_ID value already exists in the 
ORDER table and the PART_NUMBER value exists in the PART 
table. 


5. The CHECK clause insures that ORDER_ID and PART_NUMBER 
are always greater than zero. : 


Note that FOREIGN KEY ( column1, column? ) ... means that column! 
and column2 will be combined to form a single foreign key. FOREIGN 
KEY (column! )..., FOREIGN KEY ( column2 ) ... will create two 
constraints, one for each foreign key. 


CREATE TABLE statement and column element. 
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CREATE CLUSTER 


Purpose Create a cluster that may contain one or more tables. Rows of one or 
more tables which share the same cluster key value are physically 
stored together within the database. Access time to groups of rows 
with the same cluster key is therefore improved. For the definition of 
cluster key, refer to the Usage Notes. 


Prerequisites Must have RESOURCE privilege. To create a cluster owned by another 
user other than yourself you must have DBA privilege. 


Syntax CREATE CLUSTER [{user.]cluster 
{column datatype {,column datatype] ... ) 
{PCTUSED integer] [PCTFREE integer] 
[SIZE integer] 
[INITRANS integer] [MAXTRANS integer} 
(TABLESPACE tablespace] 
(STORAGE storage] 


Keywords and user is the username of the cluster owner. 
Parameters ctuster is the name of the cluster. 
column is the name of one of the columns comprising the 
cluster key. For the definition of cluster key, refer 
to the Usage Notes. 
datatype is a valid ORACLE datatype as listed in Chapter 1 


"The Relational Model” of this Manual. Note that 
NULL or NOT NULL may not be specified. 


PCTUSED specifies the limit that ORACLE will use to 

integer determine when additional rows should be added 
to a cluster’s block. integer is expressed in whole 
numbers and interpreted as a percentage. Fora 
complete description of PCTUSED, refer to the 
CREATE TABLE statement later in this chapter. 


PCTFREE specifies the space reserved in each cluster block 
integer for future expansion. integer is expressed in whole 
, numbers and interpreted as a percentage. For a 
complete description of PCTFREE, refer to the 
CREATE TABLE statement later in this chapter. 


SIZE specifies the average amount of space required to 
store all rows with the same cluster key value. 


INITRANS specifies the initial number of concurrent update 

integer transactions allocated for blocks belonging to the 
cluster. For a description of INITRANS, refer to 
the CREATE TABLE statement later in this chapter 
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Usage Notes 


Cluster Key 


CREATE CLUSTER 


MAXTRANS specifies the maximum number of concurrent 

integer update transactions for any given block belonging 
to the cluster. For a complete description of 
MAXTRANS, refer to the CREATE TABLE 
statement later in this chapter. 


TABLESPACE specifies the tablespace to which the cluster will 
tablespace belong. 


STORAGE specifies how blocks will be allocated to the 
storage cluster. Refer to the Storage clause later in this 
chapter. 


Clustering forces rows from one or more tables which share the same 
cluster key value to be stored in the same ORACLE block. 


Clustering provides more control over the physical storage of rows 
within the database. Clustering can both reduce the time it takes to 
access clustered tables and reduce the space needed to store the table. 
From a user perspective, clustered tables are treated identically to 
unclustered tables; no modification of the SQL statements used to 
access clustered tables is required. 


Asa general rule, you should cluster tables that are frequently joined 
together. While clustering will improve the performance of joins, it is 
likely to reduce the performance of full table scans for tables belonging 
to multi-table clusters. Before clustering, you should consider the likely 
query mix of joins versus full-table scans (as well as the negative 
performance ramifications of clustering for INSERTs, UPDATEs, and 
DELETES). For additional information on the advantages and 
considerations of clustering, refer to Chapter 2 "Tuning SQL Statements 
and Applications" of the ORACLE RDBMS Performance Tuning Guide. 


The cluster key determines how ORACLE will group the rows of the 
cluster. Rows with the same cluster key will be stored physically close 
together. 


The columns defined by the CREATE CLUSTER statement are known 
as the cluster key. These cluster columns must correspond in both 
datatype and size to columns in each of the clustered tables. The 
columns that comprise the cluster key for each table need not 
correspond in name. 


Each distinct cluster key value is stored only once per cluster key, no 
matter how many tables and rows it occurs in. This saves disk space 
and improves performance for many operations. 
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CREATE CLUSTER 


Cluster Size 


A cluster key value is comprised of: 


+ the ROWID (19 bytes) 


+ the internal storage for the clustered column(s) (the length of 
each column in bytes plus 1 byte overhead for each column) 


For example, this statement: 
CREATE CLUSTER XYZ (ABC CHAR(5), MNO CHAR(7)) 
creates a cluster key value of 33 bytes: 


* 19 bytes for the ROWID 
* 5and 7 bytes for the ABC and MNO columns 
¢ 2bytes overhead for both columns 


The maximum size allowed for cluster key depends on your operating 
system. 


Constraints may not be specified for cluster columns; instead, 
constraints may be associated with the tables that belong to the cluster. 


As with an index key, the order of the columns in the cluster key affects 
the structure of the cluster index. 


ORACLE uses SIZE to determine the space reserved for rows 
corresponding to one cluster key, and thus, the maximum number of 
cluster keys to store per ORACLE block. If SIZE is not a divisor of the 
ORACLE block size, ORACLE will use the next largest divisor. If SIZE 
is larger than the physical block size, ORACLE will use the physical 
block size (or, reserve at least one ORACLE block per cluster key). 


If you omit the SIZE clause, ORACLE stores one cluster key per 
ORACLE block. 


ORACLE also takes the length of the cluster key into consideration 
when setting the actual SIZE of the cluster (larger keys require larger 
SIZEs). You may examine the actual size of the cluster key by 
examining the KEY_SIZE column of the USER_CLUSTERS data 
dictionary table. 


Although the maximum number of cluster keys per ORACLE block is 
fixed on a per cluster basis, ORACLE does not reserve an equal amount 
of space for each cluster key. For example, if you specify a SIZE that 
results in six cluster keys per ORACLE block, the 6 cluster keys and 
their rows may be any size as long as their total size does not exceed 
the ORACLE block size. Variable length cluster keys store data more 
efficiently than fixed length cluster keys because the data stored per 
cluster key is rarely fixed. 
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Adding Tables to 
a Cluster 


The Cluster Index 


CREATE CLUSTER 


ASIZE smaller than the average data per cluster key may require the 
data for one cluster key to occupy multiple blocks. Conversely, a SIZE 
much larger than the average cluster key will result in wasted database 
space. 


Tables are added to the cluster with the CLUSTER clause in the 
CREATE TABLE statement. A cluster may contain at most 16 tables, 
although the performance gains of clustering are often negated when 
clustering more than four or five tables together. Tables with LONG 
columns can be clustered. 


All tables in the cluster use the cluster’s storage allocation parameters. 
These parameters include PCTUSED, PCTFREE, INITRANS, 
MAXTRANS, TABLESPACE and STORAGE. 


The cluster index provides quick access to rows within a cluster based 
on the cluster key. 


The creation of the cluster index is required before any DML operations 
may be performed on tables in the cluster. This index must be manually 
created for the cluster. The syntax: 


CREATE INDEX iname ON CLUSTER cname 


is used to create a cluster index. Note that no columns are specified in 
this CREATE INDEX statement; the index is built on the cluster key 
columns as defined by the CREATE CLUSTER statement. Refer also to 
the CREATE INDEX statement later in this chapter. 
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Example 


Related Topics 


To define a cluster named PERSONNEL that contains the sample EMP 
and DEPT tables and specifies the storage parameters for the clustered 
tables, enter: 


CREATE CLUSTER PERSONNEL ( department_number NUMBER ) 
STORAGE (INITIAL 100K NEXT 50K PCTINCREASE 10) 


To add the EMP and the DEPT tables to the cluster, enter: 


CREATE TABLE EMP 
{empno NUMBER NOT NULL, 
deptno NUMBER NOT NULL, 
wed 
CLUSTER PERSONNEL (deptno) 


CREATE TABLE DEPT 
(deptno NUMBER NOT NULL, 
dname CHAR (9), 
loc CHAR (9)) 
CLUSTER PERSONNEL (deptno) 


To create the cluster index, enter: 
CREATE INDEX idx_personnel ON CLUSTER personnel 


Having created the cluster index, you may now insert rows into either 
the EMP or DEPT tables. 


CREATE INDEX and CREATE TABLE statements; Storage clause. 
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CREATE DATABASE 


Purpose 


Prerequisites 


Syntax 


Keyword and 
Parameters 


Create a database, with options to: 


* seta maximum number of instances, database files, or redo log 


files 


* specify names and sizes of database, and redo log file(s) 


* choose a mode of use for the redo log (ARCHIVELOG or 
NOARCHIVELOG) 


Requires DBA privilege. 


Warning; This statement prepares a db for initial use, and therefore 
erases any data which may be in the files currently. Only use this 
statement when you understand its ramifications. 


CREATE DATABASE [database] 
[CONTROLPILE REUSE] 
{LOGFILE filespec [,filespec] ...] 
[MAXLOGFILES integer } 
[DATAPILE filespec [{,filespec] ...] 
{MAXDATAFILES integer] 
(MAXINSTANCES integer] 
[ARCHIVELOG | NOARCHIVELOG] 


[EXCLUSIVE] 


database 


filespec 


SIZE integer 


REUSE 


is the name of the database and may be a 
maximum of eight characters. The default 
database name is specified by the INIT.ORA 
parameter DB_NAME. The database name is 
checked by the control file whenever the database 
is mounted or opened. 


is a specification of a database file in the form: 
‘filename’ [SIZE integer [K!IM)] [REUSE] 


specifies a SIZE in a number of bytes. If the integer 
is followed by K, then SIZE is computed as the 
integer multiplied by 1024. If M is used, then SIZE 
will be the integer multiplied by 1048576. 


specifies that existing files should be reused, thus 
destroying any information they contain. 
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CONTROLFILE 
REUSE 


LOGFILE 
filespec 


MAXLOGFILES 
integer 


DATAFILE 
filespec 


MAXDATAFILES 
integer 


MAXINSTANCES 
integer 
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specifies that existing control files identified by the 
INIT.ORA parameter, CONTROL_FILES, should 
be reused, thus ignoring and overwriting any 
information they may currently contain. Not 
usually used if this is the first time a database is 
created. 


specifies one or more files to be used as redo log 
files. If you omit the LOGFILE clause, two redo 
log files are created by default. For the names and 
sizes of these default files for your operating 
system, refer to your Installation and User's Guide. 


specifies the maximum number of redo log files 
that can ever be created for this database. This 
number sets the absolute limit, and takes 
precedence over the INIT.ORA parameter 
LOG_FILES. This number cannot be increased 
except by re-creating a database. The valid range 
is 2-256. Overhead incurred by entering a higher 
number is negligible, affecting only the size of the 
control file. 


specifies one or more files to be used as database 
files. All files specified in the DATAFILE clause 
become part of the SYSTEM tablespace. If you 
omit this clause, one database file is created by 
default. For the name and size of this default file 
on your operating system, refer to your Installation 
and User's Guide. 


specifies the maximum number of database files 
that can ever be created for this database. This 
number sets the absolute limit, and takes 
precedence over the INIT.ORA parameter 
DB_FILES. This number cannot be increased 
except by re-creating a database. The valid range 
is operating system dependent, typically 1 - 255. 
Overhead incurred by entering a higher number is 


negligible, affecting only the size of the control file. 


The default is 32. 


specifies the maximum number of instances which 
can ever simultaneously mount and open this 
database. This number sets the absolute limit, and 
takes precedence over the INIT.ORA parameter 
INSTANCES. The valid range is 1 - 255. 


| 
: 
i 
‘ 








Usage Notes 


Examples 


Related Topics 


CREATE DATABASE 


ARCHIVELOG specifies the initial mode of using redo log files. 

NOARCHIVELOG The mode can be changed via the SQL statement 
ALTER DATABASE. The default, 
NOARCHIVELOG, indicates that a redo log file 
can be reused without archiving its contents; thus 
the redo log will be used only for instance recovery 
but not for media recovery. ARCHIVELOG 
indicates that redo log files will be archived before 
reuse, thereby preparing for the possibility of 
media recovery as well as instance recovery. 


EXCLUSIVE specifies how the database should be left mounted 
after creation is complete. EXCLUSIVE indicates 
that only one instance may access the database. 
Since databases are always created EXCLUSIVE, 
this keyword is entirely optional. 


For multiple instances to access the database, you 
must dismount and then mount the database 
SHARED using the DISMOUNT and MOUNT 
SHARED options of the ALTER DATABASE 
statement. 


The CREATE DATABASE statement will erase all data in the specified 
database files in order to prepare them for initial database use. Thus, if 
the statement is used on an existing database, all data will be lost. 


To create a small database using defaults for all arguments: 
CREATE DATABASE 
To fully specify each argument: 


CREATE DATABASE NEWTEST 
CONTROLFILE REUSE 
LOGFILE ’LOGONE.LOG’ SIZE 50000, 'LOGTWO.LOG’ SIZE 50000 
MAXLOGFILES 5 
DATAFILE 'DBONE.DAT’ SIZE 100000 
MAXDATAFILES 10 
MAXINSTANCES 2 
ARCHIVELOG 
EXCLUSIVE 


ALTER DATABASE, CREATE ROLLBACK SEGMENT and CREATE 
TABLESPACE statements; SQL*DBA commands: STARTUP and 


SHUTDOWN (in Appendix B "The SQL*DBA Reference" of the 
ORACLE RDBMS Database Administrator's Guide). 
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Purpose 


Prerequisites 


Syntax 


Keyword and 
Parameters 


Usage Notes 


Create a link from the local database to a username on a remote 
database. This database link may reference a remote ORACLE ora 
remote non-ORACLE database, such as an IBM DB? database. 


Must have access to a username on a remote database. Only DBAs may 
create PUBLIC database links. SQL*Net must be installed on both the 
local and remote databases. 


CREATE [PUBLIC] DATABASE LINK link 
(CONNECT TO user IDENTIFIED BY password] 
USING ’connect_string’ 


PUBLIC If the PUBLIC option is omitted, the link is private 
(available only to its creator). If the PUBLIC option 
is specified, the link is available to all users except 
those who have defined a private database link 
with the same name 


link is the name to be given to the database link 

user, password are a valid username and password on the 
specified remote database 

connect_string is the database specification of a remote database 


accessible through SQL*Net. For information on 
specifying remote databases, refer to the SQL*Net 
User's Guide for your specific SQL"Net protocol. 


Once a database link has been created, you can query a table on the 
temote database by referring to that link in the FROM clause of a query 
or subquery, with the same effect as if you were connected directly to 
the remote database as the user. 


If the clause containing the username and password is omitted, the 
database link will use the current username and password when 
invoked. For example, if SCOTT connects to his local database and 
then uses a database link that was not created with a username and 
password, ORACLE will use SCOTT and SCOTT’s password to access 
the remote database. 


Remote tables are referenced in queries by adding @linkname to remote 
tables within the FROM clause of a SELECT statement. 
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Example 


Related Topics 


CREATE DATABASE LINK 


Queries and subqueries performed through database links are subject 
to the following restrictions: 


* The number of database links that may be used in a single 
statement is initially limited in most systems to four. The DBA 
may change the limit by increasing the INIT.ORA parameter 
OPEN_LINKS. 

* LONG columns may not be selected through a database link. 

+ In tree-structured queries (using the CONNECT BY clause): 


* the PRIOR operator may not be used in clauses other than 
CONNECT BY 

« the START WITH clause may not contain subqueries 

neither the CONNECT BY clause nor the START WITH 

clause may contain the function USERENV(ENTRYID’), 

user-defined functions, or ROWNUM 


To define a database link named BOSTON that refers to user SCOTT 
with password TIGER on database D:BOSTON-MKG, enter: 


CREATE DATABASE LINK BOSTON 
CONNECT TO SCOTT IDENTIFIED BY TIGER 
USING 'D:BOSTON~MFG’ 


Once this database link has been created, you can query tables owned 
by SCOTT on D:BOSTON-MFG in the following manner: 


SELECT * FROM EMP@BOSTON 


You can also query tables owned by other users on the same database. 
This example assumes SCOTT has access to ADAM’s DEPT table: 


SELECT * FROM ADAMS.DEPT@BOSTON 


The previous statement would connect to the user SCOTT on the 
remote database and then query ADAM’s DEPT table. 


A synonym may be created to hide the fact that SCOTT’s EMP table is 
ona remote database. The following statement would cause all future 
references to EMP to access a remote EMP table owned by SCOTT. 


CREATE SYNONYM EMP FOR SCOTT .EMP@BOSTON 
The CREATE SYNONYM and SELECT statements. 
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CREATE INDEX _ 


Purpose Create an index for a table or create a cluster index. An index provides 
direct access to rows in a table, thereby reducing access time. An index 
contains an entry for each value that appears in the indexed column(s). 
Currently, indexes are also used to enforce uniqueness. 


Prerequisites Must own the table or cluster, have been granted the INDEX privilege 
on the table, or have DBA privilege. 


Syntax CREATE [UNIQUE] INDEX index ON 
{table (column [ASC|DESC][, column [ASC|DESC]}] ...) 
[CLUSTER cluster} 
[INITRANS n] [MAXTRANS n] 
[TABLESPACE tablespace] 
(STORAGE storage] 


{PCTFREE n] 
[NOSORT] 


Keywords and UNIQUE 
Parameters 


index 


table 


column 


ASC 
DESC 


CLUSTER 
cluster 


INITRANS 
MAXTRANS 


TABLESPACE 
tablespace 


STORAGE 
storage 
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ensures that the table will never contain two rows 
with the same values in all index columns. Ifa 
UNIQUE index is not created for a table, the table 
may contain duplicate rows. 


is the name of the index to be created. As with all 
database objects, the index name must be distinct 
from all other object names owned by the same 
user. 

is the name of an existing table for which an index 
is to be created. 


is the name of a column in the table. 


are allowed for DB2 syntax compatibility, although 
indexes are always created in ascending order. 


is aname of a cluster for which a cluster index is to 
be created. 


(Refer to the INITRANS and MAXTRANS 
parameters of the CREATE TABLE statement later 
in this chapter.) 


is the name of the tablespace that will hold the 
index. 


(Refer to the Storage clause later in this chapter.) 








Usage Notes 


Index Columns 


Multiple Indexes 
Per Table 


Internal Index Format 


CREATE INDEX 


PCTFREE specifies the percentage of index space to leave free 
for updates and insertions within each index biock. 
NOSORT indicates to ORACLE that the rows are stored in 


the database in ascending order and therefore 
ORACLE does not have to sort the rows when 
creating the index. For more information, refer to 
the Usage Notes. 


ORACLE can use indexes to improve the performance when: 


* accessing tables in index column order 
* searching for rows with specified index column values 


However, an index slows down insertions, deletions, and changes in 
indexed column values because the index data as well as the table data 
must be maintained. 


A maximum of 16 columns may be included in a single index. The 
index entry becomes the concatenation of all data values from each 
column. The columns may be specified in any order, and the order is 
important in terms of how ORACLE can make use of the index. 


When appropriate, ORACLE will use the entire index or a leading 
portion of the index. Assume an index named IDX1 was created on 
columns A,B, and C of table TABI (in the order A,B,C). ORACLE could 
use the index for references to columns A,B,C (the entire index); A,B; or 
just column A. References to columns B,C would not use the IDX1 
index. Of course, you also have the option to create another index for 
just columns B and C. 


You may create several indexes on different columns (or different 
combinations of columns) in the same table. Note that each index 
increases the processing time needed to maintain the table during 
updates to data. ORACLE does not impose any limits on the number 
of indexes you may create on a given table. 


An index entry for a given row is comprised of: 


* the row’s ROWID (6 bytes in a unique index, 7 bytes ina 
nonunique index) 


* the internal storage of the indexed column(s) (the length of 
each column in bytes, plus 1 byte overhead per column) 
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Unique Indexes 


Naming Conventions 


| 
| Performance 
| Considerations 


For example, a nonunique index on the ENAME CHAR(10) column 
requires a total of 18 bytes: 


* 7 bytes for the ROWID 
* 10 bytes for the length of the ENAME column 
* 1 byte overhead for the ENAME column 


The maximum size allowed for an index entry depends on your 
operating system. For descriptions of the internal format of ORACLE 
datatypes, refer to Chapter 6 "ORACLE Datatypes" of the ORACLE 
RDBMS Database Administrator's Guide. 


By creating a unique index on a column or group of columns you 
guarantee that no two rows will have the same value for the indexed 
column(s). You may create any number of unique indexes on a table. 
Most tables have at least one unique index: an index on the table’s 
primary key. 


Every index must follow the standard ORACLE naming rules and must 
have a distinct name with respect to all other objects owned by a single 
user. Additional recommendations for naming an index: 


+ Include the names of table and columns that comprise the 
index within the index name. 


* Preface the index name with I. 
* Separate the table and column names with punctuation. 


For example, an index created on the SAL and COMM columns of the 
EMP table would be named I_EMP$SAL_COMM. 


When the index is created, ORACLE will fill 1 PCTFREE of each 
index block. For example, if PCTFREE is 20, then each index block will 
be filled to 80% of its capacity. A larger value of PCTFREE permits 
more record insertion before index block splits (which require 
additional time). A smaller value of PCTFREE would be appropriate 
for a static table in which it is unlikely that the index blocks will split. 
Consequently, fewer blocks would be required for the index. A smaller 
index means faster index lookups. 


During the initial insertion of rows into a table, it is generally faster if 
you create the table, insert the rows, and then create the index. If you 
create the index before inserting the rows, the index must be updated 
on every insertion. 
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NOSORT The NOSORT option can substantially reduce the time required to 


Nulls 


Creating Cluster Indexes 


create an index. Normal index creation first sorts the rows of the table 
based on the index columns and then builds the index. The sort 
operation is often a substantial portion of the total work involved. If 
the rows are physically stored in ascending order (based on the index 
columns), then the NOSORT option allows ORACLE to bypass the sort 
phase of the CREATE INDEX process. 


You cannot use NOSORT when creating a cluster index. 


NOSORT will also reduce the amount of space required to build the 
index. ORACLE uses temporary segments during the sort. Since a sort 
is not performed, the index can be created with much less temporary 
space. 


In order to use the NOSORT option, you must guarantee that the rows 
are physically ordered in ascending order. Because of the physical data 
independence inherent in relational database management systems, 
especially ORACLE, there is no way to force a physical internal order 
ona table. CREATE INDEX with the NOSORT option should be used 
immediately after the initial load of rows into a table. 


You run no risk by trying the NOSORT option. If your table is not in 
the correct order, ORACLE will return an error, and will allow you to 
rerun the CREATE INDEX without the NOSORT option. 


Null values are not indexed. Thus the following query: 
SELECT ENAME FROM EMP WHERE COMM IS NULL 


would not use an index that had been created on the COMM column. 


Unique indexes do not consider nulls to be duplicates insertion of 
multiple rows with null values will not cause ORACLE to return an 
error. 


ORACLE does not automatically create an index for a cluster when the 
cluster is initially created. DML statements may not be issued against 
clustered tables until a cluster index has been created. Note that you 
may create either a cluster index or a table index with a single CREATE 
INDEX statement, but not both. Consequently, you may only use the 
CLUSTER clause if you have not referenced a table in the CREATE 
INDEX statement. 
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Examples 


Related Topics 


To create an index for the EMPLOYEE cluster, enter: 
CREATE INDEX IC_EMP ON CLUSTER EMPLOYEE 

Note that no index columns are specified since the index is 
automatically built on all the columns of the cluster key. 
To index the table EMP on the column ENAME, enter: 
CREATE INDEX I_EMP$ENAME ON EMP (ENAME) 


Note that it would be unwise to specify UNIQUE in this case, since two 
employees could legitimately have the same name. 


To index the table EMP on the column EMPNO, enter: 

CREATE UNIQUE INDEX I_EMPSEMPNO ON EMP (EMPNO) 

In this case UNIQUE is specified to ensure that two employees will 
never be entered in the table with the same employee number. 


ALTER INDEX, DROP INDEX and VALIDATE INDEX statements; 
Storage clause. 
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CREATE ROLLBACK SEGMENT 


Purpose 


Prerequisites 


Syntax 


Keyword and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Create a rollback segment, optionally specifying: 


+ whether the rollback segment may be allocated to any instance 
requesting it (PUBLIC) or only to instances naming it in their 
INIT.ORA files (private) 

* the tablespace to contain the segment 


* storage parameters 


Requires DBA privilege. 


CREATE [PUBLIC] ROLLBACK SEGMENT rollback_segment 
[TABLESPACE tablespace] 
{STORAGE storage] 


PUBLIC if specified, indicates that the rollback segment 
should be a public one, available for use by any 
instance. If omitted, indicates that the rollback 
segment should not be public. 


rollback_segment isa valid ORACLE identifier, of 30 characters or 


less. 
TABLESPACE names the tablespace in which the rollback 
tablespace segment will be created. The default tablespace is 
SYSTEM. 


STORAGE storage specifies the storage allocation for the rollback 
segment. Refer to the Storage clause later in this 
chapter. 


The tablespace must be online when a rollback segment is added to it. 
A tablespace may have multiple rollback segments. Generally, multiple 
rollback segments will improve performance. For a discussion of the 
optimum number and size of the rollback segments, refer to Chapter 5 
“Tuning Contention" of the ORACLE RDBMS Performance Tuning Guide. 


To create a rollback segment in the SYSTEM tablespace, enter: 


CREATE PUBLIC ROLLBACK SEGMENT RBS_2 
TABLESPACE SYSTEM 
STORAGE (INITIAL 50000 NEXT 50000 MAXEXTENTS 10) 
CREATE TABLESPACE, CREATE DATABASE, ALTER ROLLBACK 
SEGMENT, and DROP ROLLBACK SEGMENT statements; Storage 
clause. 
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CREATE SEQUENCE 


Purpose Establish a database object from which multiple users may generate 
unique integers. Sequence numbers may be used to generate primary 
keys automatically. 


Prerequisites Requires RESOURCE privilege on at least one tablespace. Requires 
DBA privilege when creating a sequence that you do not own. 


Syntax CREATE SEQUENCE [user.] sequence 
(INCREMENT BY nj 
{START WITH n] 
[MAXVALUE n | NOMAXVALUE] 
[MINVALUE n [| NOMINVALUE) 
[CYCLE | NOCYCLE] 
(CACHE n | NOCACHE] 
{ORDER | NOORDER} 





Keywords and user is the owner of the sequence and defaults to the 
Parameters user issuing the CREATE SEQUENCE statement. 
sequence is the name of the sequence and follows the 


standard convention for naming database objects. 


INCREMENT BY _ determines the interval between sequence 
numbers. If the increment is negative, then the 
sequence will descend; if the increment is positive 
the sequence will ascend. Any non-zero ORACLE 
integer is allowed and the default is 1 (ascending). 


START WITH is the first sequence number to be created. The 
default is MINVALUE for ascending sequences 
and MAXVALUE for descending sequences. Use 
this clause when an ascending sequence should 
not start at MINVALUE or a descending sequence 
should not start at MAXVALUE. 


MINVALUE is the minimum value the sequence will generate. 

NOMINVALUE MINVALUE provides a lower bound for the 
sequence. For ascending sequences, the default is 1. 
For descending sequences, the default is 10e27 - 1. 


MAXVALUE is the maximum value the sequence will generate. 

NOMAXVALUE MAXVALUE provides an upper bound for the 
sequence. For descending sequences, the default is 
1. For ascending sequences, the default is 10e27 - 1. 
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Usage Notes 


CYCLE 
NOCYCLE 


CACHE 
NOCACHE 


ORDER 
NOORDER 


CREATE SEQUENCE 


The default, NOCYCLE, specifies that no 
additional sequence numbers should be generated 
once the end of the sequence is reached. Any 
attempt to generate a number past the end of the 
sequence will return an error. 


If CYCLE is specified, then the sequence will 
return to MINVALUE after reaching MAXVALUE 
for ascending sequences. For descending 
sequences, the sequence will return to 
MAXVALUE after reaching MINVALUE. 


CACHE pre-allocates sequence numbers so that 
the sequence numbers may be kept in memory, 
resulting in faster generation of sequence numbers. 
CACHE is useful for applications with high 
performance requirements. 


The default is CACHE 20. The value specified for 
CACHE must be less than MAXVALUE minus 
MINVALUE. 


ORDER specifies that sequence numbers will be 
guaranteed to be generated in order of request. 
This is often important for applications that use 
sequence numbers as timestamps. This is usually 
not important for tables that use sequences to 
generate primary keys. Even without ORDER, 
sequence numbers are likely to be generated in 
order. 


You can use sequence numbers to automatically generate unique 
primary keys for your data, and you can also coordinate the keys 
across multiple rows or tables. To create a sequence you must have 
RESOURCE privilege on at least one tablespace. You must be granted 
SELECT privilege to access a sequence that you do not own. A DBA 
may create a sequence whose owner is different from its creator. 
Sequences can be altered, audited or dropped. A sequence may have 


a synonym. 
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CREATE SEQUENCE 


SEQUENCE Defaults 
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Sequence Growth 


Actual ORACLE sequence numbers for any given sequence are 
automatically generated by ORACLE and consequently, sequences 
avoid the performance bottleneck which results from implementation 
of a sequences at the application level. For example, one common 
application-level implementation is to force each transaction to lock a 
sequence number table, increment the sequence, and then release the 
table. Under this implementation, only one sequence number may be 
generated at a time. In contrast, ORACLE sequence number generators 
permit the simultaneous generation of multiple sequence numbers 
while guaranteeing that every sequence number is unique. 


Because sequence numbers are generated independently of tables, the 
same sequence generator can be used for one or for multiple tables. It 
is possible that individual sequence numbers will appear to be skipped, 
because they were generated and used in a transaction that ultimately 
rolled back. Additionally, a single user may not realize that other users 
are drawing from the same sequence. 


To see what sequences you have access to, query the Data Dictionary 
views USER_SEQUENCES and ALL_SEQUENCES. 


Sequences can be imported and exported just like tables. Export 
preserves the sequence number so that after import, sequence numbers 
will resume just as though no export or import had occurred. 


The sequence defaults are designed so that if you specify none of the 
clauses, you will create an ascending sequence that starts with 1 and 
increases by 1 with no upper limit. If only INCREMENT BY -1 is 
specified, you will create a descending sequence that starts with -1 and 
decreases with no lower limit. The clauses listed under Keyword and 
Parameters allow for variations on these standard sequences. 


A sequence may: 


* grow without bound 
* stop at a predefined limit 
* restart after reaching a predefined limit 
To create a sequence that grows without bounds, do not specify a 


MAXVALIUE for ascending sequences or a MINVALUE for descending 
sequences. Specify NOCYCLE. 
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Using CACHE 


NEXTVAL 


CREATE SEQUENCE 


To create a sequence that stops at a predefined limit, specify a 
MAXVALUE for an ascending sequence limit or a MINVALUE for 
a descending sequence limit. Specify NOCYCLE. Any attempt to 
generate a sequence number once the sequence has reached its limit 
returns an error. 


To create a sequence that restarts after reaching a predefined limit, 
specify both a MAXVALUE and a MINVALUE. Also specify CYCLE. 


START WITH only affects the very first sequence number. The 
sequence will cycle back to MINVALUE for ascending sequences 
and back to MAXVALUE for descending sequences. 


The number of sequence numbers per sequence cached in memory is 
determined by the argument supplied with CACHE. Cached sequences 
allow faster generation of sequence numbers. A cache for a given 
sequence is populated at the first request for a number from that 
sequence. If the system crashes, all cached sequence values that have 
not been used in committed DML statements are lost. The potential 
number of lost values is therefore equal to the value given in the 
CACHE clause. 


Parameters affecting all sequences are set in the INIT.ORA file, as 
documented in Appendix D "The INIT.ORA Parameters" of the 
ORACLE RDBMS Database Administrator's Guide. 


A CACHE of 20 future sequences is the default and specifies that 
ORACLE pre-generate 20 sequence numbers at a time and store them 
in memory for faster access. 


The pseudo-column NEXTVAL is used to generate a sequence number 
from the specified sequence. A reference to NEXTVAL causes a 
sequence number to be generated. The syntax of NEXTVAL is: 


sequence .NEXTVAL 


where sequence is the name of the sequence. For a discussion of where 
NEXTVAL may be used, refer to the following sections. 
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CREATE SEQUENCE 
CURRVAL 


When to Use NEXTVAL 
and CURRVAL 


Restrictions on 
NEXTVAL and 
CURRVAL 


Example 


The pseudo-column CURRVAL is the current value of the sequence. 

A reference to NEXTVAL for a given sequence causes the current 
sequence number to be placed in CURRVAL. NEXTVAL must be used 
to generate a sequence number in the current session before you can 
reference CURRVAL. 

The syntax for CURRVAL is: 

sequence .CURRVAL 


where sequence is the name of the sequence referenced in NEXTVAL. 


NEXTVAL and CURRVAL may be used within: 


* the SELECT clause of a SELECT statement (except for views) 
e the values list of an INSERT statement 
* the SET expression of an UPDATE statement 
NEXTVAL and CURRVAL may not be used: 
¢ within a subquery 
* within the select list of a view 
* with the keyword DISTINCT 


* with the ORDER BY, GROUP BY, and HAVING clauses of the 
SELECT statement 


+ witha set operator (UNION, INTERSECT, MINUS) 


After a sequence has been created it can be used to generate unique 
sequence numbers. In the following examples, assume user ELLY 
created a sequence named ESEQ: 


CREATE SEQUENCE ESEQ INCREMENT BY 10 


The first reference to ESEQ.NEXTVAL will return 1 and the next 
reference will return 11. Each subsequent reference will return a 
value 10 greater than the last. 


Always prefix NEXTVAL with the sequence name, as in 
ESEQ.NEXTVAL. You should not reference NEXTVAL more 
than once in a single statement for a given sequence. Multiple 
references to NEXTVAL in a single SQL statement will cause 
all references to use the same sequence number. 
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Sequences in an 
UPDATE Statement 


Related Topics’ 


CREATE SEQUENCE 


NEXTVAL can be embedded in a DML statement, as in: 
INSERT INTO EMP VALUES (ESEQ.NEXTVAL, ‘LEWIS’, ‘TIMOTHY’) 


assuming the EMP table has just three columns (EMPNO, 
LAST_NAME, FIRST_NAME). 


When a sequence number is generated, the sequence is incremented, 
independent of the transaction committing or rolling back. If two users 
are accessing the same sequence at the same time, the sequence 
numbers either user sees may have gaps, because sequence numbers 
are being generated by the other user. Two users will never see the 
same sequence number generated by the same sequence. 


After the preceding insert, the following statement may be executed: 
INSERT INTO EMP_PROJ VALUES (ESEQ.CURRVAL, 101 } 


assuming the EMP_PROJ table has two columns (EMPNO and 
PROJNO). 


Referencing both NEXTVAL and CURRVAL for the same sequence ina 
single SQL statement results in the NEXTVAL being used for both, no 
matter what order the words appear. 


To see the last sequence number that you generated within your 
session, you may enter: 


SELECT ESEQ.CURRVAL FROM any_table 


Suppose your manufacturing plant makes televisions. You use the 
sequence number generator to construct serial numbers for each 
television as it is produced. A random number of televisions are tested 
and each test record is updated with the serial number of the television 
involved. Using the TV_SERIAL sequence, the insertion of the rows 
into the TV table and the update of the TEST_RESULT table would be 
entered as: 


INSERT INTO TV VALUES (TV_SERIAL.NEXTVAL, SYSDATE, ‘19 INCH’) 


UPDATE TEST_RESULT 
SET TV_NUMBER = TV_SERIAL.CURRVAL 
WHERE TEST_NUMBER = 1015 
ALTER SEQUENCE, AUDIT, DROP SEQUENCE, and GRANT and 
REVOKE statements; Primary Keys in Chapter 1 "The Relational 
Model" of this Manual. 
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CREATE SYNONYM 


Purpose Create a synonym for a table, view, or sequence name with options for: 


* creating a PUBLIC synonym 
* creating a synonym which references a table within a remote 


database 


Prerequisites You must be the owner of or have SELECT privilege on the table or 


view to create a synonym for it. You must have DBA privilege to create 


a PUBLIC synonym or a synonym owned by another user. 


Syntax CREATE {PUBLIC] SYNONYM [user.]synonym 
FOR [user.]table {@databaselink]} 


Keywords and PUBLIC 
Parameters 


synonym 


user 


table 


databaselink 


Usage Notes Synonyms are used for reasons of security and convenience, including: 


+ toreference a table or view without specifying the owner of the 


specifies that this synonym shall be accessible by 
all users. The default type, a private synonym, is 
accessible by the synonym’s creator only. 


is the name of the synonym and follows the 
convention for naming objects. 


is an existing username in the database. If user is 
omitted, the CREATE SYNONYM statement 
assumes that you own the table or view. 


is an existing table, view, or sequence in the 
database. 


is an existing link to a remote database. If user is 


omitted, the synonym refers to a table belonging to 


the username specified by the database link. 


table or view 


+ toreference a table or view without specifying the database in 
which the table or view exists 


+ to provide another name for the table 


The above reasons provide both data independence and location 
transparency; synonyms permit applications to function without 
modification regardless of which user owns the table or view and 
regardless of which database holds the table or view. 
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} 
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Scope 


Examples 


Related Topics 


CREATE SYNONYM 


A private synonym name must be distinct from all other objects owned 
by the same user. ORACLE attempts to resolve references to objects at 
the user level before resolving references at the PUBLIC synonym level. 
For instance, assuming SCOTT owns a table named DEPT and the DBA 
creates a PUBLIC synonym named DEPT for BLAKE.DEPT. If SCOTT 
then issues the following statement: 


SELECT * FROM DEPT 


this statement will return rows from SCOTT.DEPT. To retrieve rows 
from BLAKE’s DEPT table, SCOTT would have to preface DEPT with 
the owner name as in: 


SELECT * FROM BLAKE.DEPT 
ORACLE will only use a synonym when resolving references to a table 
or a view if both of these cases are true: 

* the table or view is not prefaced by a username 

* the table or view is not followed by a database link 
Assuming that you have been granted access to SCOTT’s 
MARKET_RESEARCH table, to define the synonym MARKET 


referring to the table MARKET_RESEARCH created by user SCOTT, 
you would enter: 


CREATE SYNONYM MARKET 
FOR SCOTT .MARKET_ RESEARCH 


To create a PUBLIC synonym for SCOTT’s EMP table on the remote 
SALES database, a DBA could enter: 


CREATE PUBLIC SYNONYM EMP 
FOR SCOTT.EMP@SALES 


Note that a synonym may have the same name as the base table as long 
as the base table is owned by another user. 


CREATE DATABASE LINK, CREATE TABLE, and CREATE VIEW 
statements. 
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CREATE TABLE 


Purpose Create a table, the basic structure to hold user data, with options to: 


+ determine database space allocation 


+ specify the table’s tablespace 
+ cluster the table 
+ load the table with results from an arbitrary query 


Prerequisites | Requires RESOURCE privilege. Requires DBA privilege to create a 
table not owned by yourself. 


Syntax CREATE TABLE [user.]table 
( {column_element | table_constraint } 
l, {column element | table_constraint} ].-.) 


{PCIFREE n] 


(PCTUSED nj 


(INITRANS n] [MAXTRANS nj 

[TABLESPACE tablespace} 

[STORAGE storage] 

(CLUSTER cluster (column (, column] ...)] 


{AS query] 


Keywords and = user 
Parameters 


table 


column_element 


table_constraint 


tablespace 
storage 


cluster 
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is the owner of the table. When not specified, the 
user issuing the CREATE TABLE statement 
becomes the owner of the table. 


is the name of the table and follows the standard 
convention for naming database objects (including 
the rule that tables, views, clusters, indexes, data- 
base links, synonyms, and sequences must have 
distinct names for a given user). 


defines the columns and optional column 
constraints of the table. A table must contain at 
least one column. Refer to the syntax description 
of column_element earlier in this chapter. 


defines the table constraints of the table. Refer to 
the Constraint clause earlier in this chapter. 


defines the tablespace in which the table will exist. 


defines future space allocation. Refer to the 
Storage clause earlier in this chapter. 


names an existing cluster owned by the user. 


query 


CREATE TABLE 


is a valid query as defined in the SELECT clause 
chapter. When you specify a query, you may 
only name the columns in the CREATE TABLE 
statement; the columns’ datatypes and sizes are 
copied from the corresponding columns listed in 
the query. 


If all columns in the query have well-defined and 
unique names, (column,...) may be omitted, and the 
names of the columns in query will be used. If 
(column,...) is specified, the number of columns 
must equal the number of columns in query. After 
the table is created, the results of query are inserted 
into the new table. A query may not include an 
ORDER BY or a FOR UPDATE clause. 


If query is used, the column_element clause may only 
contain column names. The datatype and length of 
each column are derived from results of query. 
Column and table constraints may be added with 
the ADD clause of the ALTER TABLE statement. 
To modify column and table constraints you must 
DROP the constraint and then ADD it. 


The following clauses may be specified in any order, but the query must 


be last, if specified. 


PCTFREE 





PCTFREE reserves a set amount of room in every 
block allocated to a table for future updates to that 
table’s data. PCTFREE is specified as a positive 
integer from 0 to 100 indicating what percent of the 
block will be reserved for updates to rows in that 
block. A PCTFREE value of 0 means that the entire 
block will be filled. 100 is not a useful value as no 
rows could be inserted into the table. PCTFREE 
defaults to 10. If the default of 10 is chosen, then 
insertion of rows into the table can fill at most 90% 
of each block. 


PCTFREE has the same function in CREATE 
CLUSTER and CREATE INDEX. The combination 
of PCTFREE and PCTUSED determines whether 
inserted rows will go into existing blocks or into 
new blocks. 
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CREATE TABLE 
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PCTUSED 
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The freespace reserved by PCTFREE allows for 
expansion of rows within a block. Rather than 
expanding into additional blocks, the updated 
rows expand into the freespace. After the freespace 
has been exhausted, the updated rows will require 
space in additional blocks, so they form chained 
rows. Chained rows reduce performance because 
more work has to be done to access the same 
information. PCTFREE should be chosen after a 
careful estimation of how much the rows may 
expand in the table. Too small a PCTFREE will 
cause excessive chaining. Too large a PCTFREE 
will result in unused space. 


PCTUSED specifies the minimum level of space 
usage that ORACLE will maintain for each block 
of the table. A block becomes a candidate for row 
insertion when its space usage falls below 
PCTUSED. PCTUSED is specified as a positive 
integer from 0 to 100. PCTUSED defaults to 40. 


Rows will be inserted into blocks in which the 
space usage of the block is less than the PCTUSED 
value. Blocks become candidates for row insertion 
and are put ona free block list for a given table 
when the block space utilization falls below the 
PCTUSED limit. Blocks are removed from the 

free block list when insertions cause the space 
utilization to reach the PCTFREE limit. Tables that 
see few deletions can operate with the default 
PCTUSED of 40 or lower. A higher PCTUSED 
value will result in more efficient use of space 
within the table at the expense of reduced 
performance as ORACLE will have to do 

more work to manage the free block list. 


PCTUSED has the same function in the CREATE 
CLUSTER statement. 





| 


MAXTRANS 


INITRANS 


TABLESPACE 


STORAGE 


CREATE TABLE 


MAXTRANS specifies the maximum number of 
transactions that may update a data block con- 
currently. Each transaction that updates a block 
requires a transaction entry (not SELECTs from). 
The space used by a transaction entry is operating 
system dependent, and is usually 23 bytes — 
allocated from the block’s freespace. MAXTRANS 
may range from 1 to 255 and defaults to 255. With 
a normal amount of freespace, it is more likely that 
you will run out of freespace before you exceed the 
MAXTRANS limit. 


MAXTRANS serves the same purpose in a cluster 
as ina table. 


INITRANS is the initial number of transaction 
entries that are allocated within each block. 
ORACLE reserves 23 bytes of space in the block’s 
free space (operating system dependent) for each 
transaction entry when the data block is first used. 
INITRANS may range from 1 to 255 and defaults 
to 1, When the number of concurrent transactions 
exceeds INITRANS, transaction entries will be 
dynamically allocated up to MAXTRANS or until 
the block runs out of freespace. 


INITRANS therefore insures that at least 
INITRANS number of concurrent transactions will 
be able to update the block. INITRANS also helps 
prevent the overhead required to dynamically 
allocate a transaction entry. 


INITRANS serves the same purpose in clusters and 
indexes as in tables, except that the minimum and 
default INITRANS value for a cluster or index is 2, 
rather than 1. 


TABLESPACE names the tablespace in which the 
table will be created. If no tablespace is specified 
then the table is created in the user’s default 
tablespace, as defined in the ALTER USER 
statement. 


STORAGE controls space allocation for the table. 
This clause has important performance 
ramifications for large tables. Storage should be 
allocated to minimize how frequently a table must 
allocate additional space. Refer to the Storage 
clause later in this chapter. 
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CREATE TABLE 


Usage Notes 


Combined Effects of 
PCTUSED and PCTFREE 


Data Dictionary 
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CLUSTER CLUSTER specifies that the table is to be included 
in the specified cluster. The columns are the table 
columns that correspond to the cluster’s cluster 
columns. Generally, the cluster columns of a table 
will be the column or columns that comprise the 
primary key or a portion of the primary key. , 
Specify one column from the table for each column 
in the cluster key. The columns will be matched 
by position, not by name. A table will use the 
cluster’s space allocation and therefore PCTFREE, 
PCTUSED, TABLESPACE and STORAGE will 
generate an error when used in conjunction with 
the cluster option. 


A table may have up to 254 columns. A table must conform to the 
standard database object naming conventions. 


Tables are created with no data unless a query is specified. Rows are 
normally added to the table with the INSERT statement. 


When used together, PCTFREE and PCTUSED can help you use space 
within a table more efficiently. The sum of PCTFREE and PCTUSED 
must not equal or exceed 100. 

‘As rows are inserted, ORACLE will first try to insert rows into a block 
from the free block list. Such blocks would also include blocks with no 
rows. ORACLE will continue to insert into blocks from the free list 
until all the blocks in the free list have reached the PCTFREE limit. 
Once all the blocks from the free list have been used, then a new block 
will be allocated to hold the row. 


The CREATE TABLE statement causes ORACLE to store information 
about the table, its columns, and constraints in the Data Dictionary. 
Any operation which changes the structure of the table automatically 
causes this change to be reflected in the Data Dictionary. 


These Data Dictionary views track table-related information: 
* USER_TABLES 
* USER_OBJECTS 
* USER_TAB_COLUMNS 
* USER_INDEXES 
+ ALL_TABLES 


Constraints 


Examples 


Related Topics 


CREATE TABLE 


ORACLE Version 6 supports the syntax of column and table 
constraints. Semantic support for constraints will be provided in a 
future version. 


To define the sample table EMP, as user SCOTT, you could enter: 


CREATE TABLE EMP 
(EMPNO NUMBER NOT NULL PRIMARY KEY, 
ENAME CHAR(10) NOT NULL CHECK (ENAME = UPPER(ENAME)), 
JOB CHAR (9), 
MGR NUMBER REFERENCES SCOTT.EMP (EMPNO), 
HIREDATE DATE CHECK (HIREDATE >= SYSDATE), 
SAL NUMBER(10,2) CHECK (SAL > 500), 
COMM NUMBER(9,0) DEFAULT NULL, 
DEPTNO NUMBER(2) NOT NULL REFERENCES SCOTT .DEPT (DEPTNO) ) 
PCTFREE 5 PCTUSED 75 


This table definition specifies a PCTFREE of 5 and a PCTUSED of 75, 


which would be appropriate for a relatively static table. The definition 
also places a number of constraints on the columns of the EMP table. 


To define the sample table SALGRADE in the HUMAN_RESOURCE 
tablespace using a small storage with limited allocation potential, you 
would enter: 


CREATE TABLE SALGRADE (GRADE NUMBER, 


LOSAL NUMBER, 
HISAL NUMBER) 
TABLESPACE HUMAN_RESOURCE 
STORAGE (INITIAL 6144 WEXT 6144 
MINEXTENTS 1 MAXEXTENTS 5 
PCTINCREASE 5S) 


ALTER TABLE, CREATE CLUSTER, CREATE INDEX, CREATE 
TABLESPACE, and DROP TABLE statements; Constraint and Storage 
clauses; Column Element. 
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CREATE TABLESPACE 


Purpose Create a tablespace, specifying: 


«the names of the files that comprise the tablespace 


* default storage parameters 
* whether the tablespace should be online or offline after creation 


Prerequisites Requires DBA privilege. 


Syntax CREATE TABLESPACE tablespace 
DATAFILE filespec [,filespec] ... 
[DEFAULT STORAGE storage] 
(ONLINE | OFFLINE) 


Keywords and tablespace 
Parameters 


filespec 


SIZE integer 


REUSE 


DATAFILE 


filespec 


DEFAULT 
STORAGE 


ONLINE 
OFFLINE 
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is an ORACLE identifier of up to 30 characters 
used to name the tablespace. 


is a specification of a database file in the form: 
‘filename’ [SIZE integer [KIM]] [REUSE] 


specifies a SIZE in a number of bytes. If the integer 
is followed by K, then SIZE is computed as the 
integer multiplied by 1024. If M is used, then SIZE 
will be the integer multiplied by 1048576. 


specifies that any existing file(s) should be reused, 
thereby destroying any information the file(s) 
contain. 


specifies the file or files that comprise the table- 
space. The exact filename specification is 
operating system specific. 


are the default storage parameters for all objects 
created in the tablespace. The default tablespace 
storage is operating system specific. Fora 
complete description of storage specification, refer 
to the Storage clause later in this chapter. 


makes the tablespace accessible or inaccessible 
respectively. The default, ONLINE, means that the 
tablespace will be available immediately for users 
who have been granted access to the tablespace. 
The Data Dictionary view DBA_TABLESPACES 
indicates the ONLINE or OFFLINE status of each 
tablespace. 


i 
| 
} 





Usage Notes 


SIZE and REUSE 


Example 


Related Topics 


CREATE TABLESPACE 


A tablespace is the unit of backup and recovery within the database. It 
contains table, index, rollback, and temporary segments. All databases 
have at least one tablespace, SYSTEM, which is created when the data- 
base is created. Operating system files may be added to any tablespace 
dynamically while the tablespace is online or offline. Tablespaces may 
be dropped when the tablespace is online or offline. It is recommended 
that you take the tablespace offline before dropping it. By taking a 
tablespace offline, you insure that no transactions are open against the 
tablespace. 


Once you have created a tablespace, you should create at least one 
rollback segment for it. 


If you specify both a SIZE value and the REUSE keyword, ORACLE 
uses the specified database file if it already exists and has the specified 
size. If not, ORACLE creates the file with the specified size. 


If you specify a SIZE value and omit the REUSE keyword, the database 


file must not already exist. In this case, ORACLE creates the file with 
the specified size. 


If you omit the SIZE value, the database file must already exist. 


To create a tablespace with one physical datafile, enter: 


CREATE TABLESPACE TABSPACE_2 
DATAFILE ’TABSPACE_FILE2.DAT’ SIZE 20M 
DEFAULT STORAGE (INITIAL 10K NEXT 50K 
MINEXTENTS 1 MAXEXTENTS 999 
PCTINCREASE 10) 
ONLINE 


ALTER TABLESPACE and DROP TABLESPACE statements. 
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CREATE VIEW 


Purpose Define a view (a logical table based on one or more tables). 


5-74 


Prerequisites | Must own or have SELECT privilege on the base table(s). Must have 
DBA privilege to create a view not owned by yourself. 


Syntax CREATE VIEW [user.]view [(alias {,alias]...)] 


AS query 


[WITH CHECK OPTION [CONSTRAINT constraint]] 


Keywords and = user 


Parameters Pon 


query 


WITH CHECK 
OPTION 


CONSTRAINT 
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is the owner of the view to be created. 
is the name of the view. 


identifies columns and rows of the table(s) that the 
view is based on. The query may be any valid 
SELECT statement without the ORDER BY and 
FOR UPDATE clauses. Refer to the syntax 
description of query in Chapter 6 "SELECT 
Statement Clauses" of this Manual. 


specifies that inserts and updates performed 
through the view should not be allowed to create 
or result in rows that the view cannot select. The 
WITH CHECK OPTION may be used in a view 
that is based on another view. 


is the name assigned to the WITH CHECK 
OPTION constraint. If no constraint name is 
supplied, then the constraint is supplied with a 
system assigned name of the form SYS_Cn, where 
nis an integer that makes the constraint name 
unique within the system. 


Usage Notes 


Naming Guidelines 


CREATE VIEW 


A view is a logical window of one or more tables. Views have the 
following properties: 


¢ A view stores no data; rather, it displays data from other tables 
(which may in turn be views). 

- Aview may be used in a SQL statement anywhere you may 
use a table (e.g., INSERT, UPDATE, DELETE, SELECT) with 
the restriction that you may only select from views if the view 
query contains: 

* ajoin 

« aGROUP BY, CONNECT BY or START WITH clause 

* the DISTINCT clause, pseudo-columns (e.g. ROWNUM) 
or expressions in the column list 


You may update a view that contains pseudo-columns or expressions 
as long as the UPDATE statement does not refer to any of the 
pseudo-columns or expressions of the view. 


Views are used to: 


* provide an additional level of table security, by restricting 
access to a predetermined set of rows and/or columns of a base 
table. 

° hide data complexity. For example, a view may be used to act 
as one table when actually several tables are used to construct 
the result. 

* present the data from another perspective. For example, views 
provide a means to rename columns without actually affecting 
the base table’s definition. 

* provide a level of referential integrity. 


The view column names must conform to the following guidelines: 


* Column names must follow the standard naming conventions 
for database objects as detailed in Chapter 3 "Elements of the 
SQL Language" of this Manual. 

» Column names must use an alias if they derive from 
expressions in the query. 

* Column names must be distinct (tables that comprise a view 
could have identically named columns). 

+ Column names will be derived from the query columns unless 
column aliases are used. Column aliases may also be used in 
the select list of the query. 
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AUDITING VIEWS 


Examples 


When aliases are used, the aliases must match in number to the 
columns selected in the query. For example, if the query selects 
four columns, then there must be four aliases. The first query 
column will be assigned the first alias, the second query 
column will be assigned the second alias, and so on. 


When you access a view, ORACLE performs the following steps: 


1. Retrieves the view definition as specified in the CREATE VIEW 
statement and stored in the data dictionary. 


2. Checks your access privileges. 


3. Uses the view query to retrieve the data from the base table(s). A base 
table is any table listed in the view query. 


Note that if a view is defined with the "AS SELECT * FROM tablename" 
construct and the table is subsequently altered to add new columns, 
then the view will no longer work. This may be corrected by dropping 
and re-creating the view. 


The default audit options for a view are the union of all the audit 
options for the tables that comprise the view. 


To create a view named DEPT20 of table EMP that shows the 
employees in Department 20 and their annual salary , enter: 


CREATE VIEW DEPT20 
AS SELECT ENAME, SAL*12 ANNUAL_SALARY 
FROM EMP 
WHERE DEPTNO = 20 


Note that a view column alias was not required for the SAL*12 
expression because a query column alias (ANNUAL_SALARY) was 
used. 


To create a view named ROSTER of all employees in EMP that shows 
only their IDs, names, titles, and department number (and includes the 
WITH CHECK OPTION constraint named WCO), enter: 


CREATE VIEW ROSTER (ID_NUMBER, PERSON, TITLE) 
AS SELECT EMPNO, ENAME, JOB, DEPTNO 
FROM EMP 
WHERE DEPTNO IN (SELECT DISTINCT DEPTNO FROM DEPT) 
WITH CHECK_OPTION CONSTRAINT WCO 
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Related Topics 


CREATE VIEW 


Because of the WITH CHECK OPTION, ORACLE would prevent you 
from inserting a new row into the view ROSTER if the new employee's 
department number did not exist in the DEPT table. Note that the row 
would actually be inserted into the EMP table only after passing the 
WITH CHECK OPTION test. 


CREATE TABLE, CREATE SYNONYM, DROP VIEW, and RENAME 
statements, 
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DECLARE CURSOR (Embedded SQL) 


Purpose 


Prerequisites 
Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Define a cursor by giving it a name and associating it with a particular 
SELECT statement. The cursor is not allocated until it is OPENed. 


None. 


EXEC SQL [AT dbname] DECLARE cursor name CURSOR 
FOR (SELECT substatement | statement} 


AT dbname indicates the optional AT clause that uses the 
name of a database that has been previously 
declared in a DECLARE DATABASE statement 
and used in an embedded SQL CONNECT 


statement. 
cursor_name is the name to be assigned to the cursor. 
substatement is a SELECT statement with no INTO clause. 
statement is the name of a statement that has been previously 
declared in an embedded SQL DECLARE 
STATEMENT statement. 


The DECLARE CURSOR statement is a declarative SQL statement and 
as such must occur in the precompiler source before any other SQL 
statement that references that cursor. ORACLE can interpret a reference 
to a cursor only when the cursor has been previously declared. The 
scope of a cursor declaration is global within the source file of the 
current module; this is distinct from ORACLE’s or the host language’s 
scoping rules. For example, a cursor cannot be DECLAREd in 
procedure specification which is separately compiled from its body. 


Every DECLARE CURSOR statement must be unique; you cannot 
declare two cursors of the same name in one compilation unit. 


If the FOR UPDATE OF clause is specified in the SELECT statement, 
the cursor can be referenced in an UPDATE using WHERE CURRENT 
OF CURSOR. The declared cursor can be used in subsequent WHERE 
CURRENT OF CURSOR if the cursor is in an open state and is 
positioned on a row by a FETCH. 


EXEC SQL DECLARE Cl CURSOR 
POR SELECT ename, empno, job, sal FROM emp 
WHERE deptno = :deptno 
POR UPDATE OF SAL 


SELECT, SELECT (Embedded SQL), PREPARE, OPEN cursor, FETCH, 
and CLOSE cursor statements. 
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Ee 
DECLARE DATABASE (Embedded SQL) 


Declare the name of a remote database that is referenced in subsequent 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


SQL statements using the AT clause. 


Must have access to a valid ORACLE username on the remote database. 


EXEC SQL DECLARE dbname DATABASE 


dname is the identifier assigned to the database. 


Once the name of the database has been declared, you can refer to that 
database in the AT clause of any of these embedded SQL statements: 


* COMMIT 

¢ DECLARE CURSOR 
* DELETE 

« INSERT 

* ROLLBACK 

¢ SELECT 

° UPDATE 


For additional information, refer to the Programmer's Guide to the 
ORACLE Precompilers manual. 


user 2 string (1..10); 
pass : string (1..10); 
my_database : string (1..10); 


user t= "scott"; 
Pass := "tiger"; 
my_database := "D:CHICAGO"; 


EXEC SQL DECLARE oraclel DATABASE; 


EXEC SQL CONNECT :user 
IDENTIFIED BY :pass 
AT oraclel 
USING :my_database; 


EXEC SQL AT oraclel SELECT ... ; 
CONNECT and COMMIT RELEASE embedded SQL statements. 
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DECLARE STATEMENT (Embedded SQL) 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Assign a SQL variable name to a SQL statement. The declared 
statement can then be referenced by a PREPARE, EXECUTE, or 
EXECUTE IMMEDIATE statement. 


None. 


EXEC SQL DECLARE statement name STATEMENT 


statement_name is the identifier for the statement. 


The use of the DECLARE STATEMENT statement is required only if 
the DECLARE CURSOR referencing a particular statement is executed 
before the PREPARE statement. If the PREPARE precedes the OPEN 
cursor, the DECLARE STATEMENT is not required. 


The DECLARE STATEMENT should appear (if used) in the text before 
a DECLARE CURSOR, OPEN cursor, DESCRIBE, or PREPARE 
statement is performed on the declared statement. 


The scope of a statement declaration is global within the compilation 
unit of the current module (identical to a cursor declaration)—this is 
distinct from ORACLE’s and the host language's scoping rules. For 
example, a statement cannot be DECLAREd in procedure specification 
which is separately compiled from its body. 


This example shows a typical sequence when using the DECLARE 
STATEMENT: 

EXEC SQL DECLARE s STATEMENT; 

EXEC SQL PREPARE s USING :my_string; 

EXEC SQL DECLARE ¢ CURSOR FOR s; 


PREPARE, OPEN cursor, FETCH and CLOSE cursor statements. 
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DELETE 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Remove rows froma table. 


You must be the owner of the table, have DBA privilege, or have 
DELETE privilege on the table. 


DELETE [FROM] [user.]table [alias] [WHERE condition] 


user is the owner of the table. 

table is the name of the table or view from which rows 
will be deleted. 

alias is an alias assigned to the table and is generally 
used in DELETE statements with correlated 
queries. 

condition follows the convention for conditions as detailed in 


Chapter 3 "Element of the SQL Language” of this 
Manual. A condition must evaluate to TRUE or 
FALSE. 


If WHERE is omitted, all rows are deleted. If WHERE is specified, all 
rows for which condition is TRUE are deleted. The condition may 
reference the target table and may include a correlated query. 


All table and index space released by the deleted rows is retained by 
the table and index. 


To delete all rows from a table named TEMP_ASSIGN, enter: 
DELETE FROM TEMP ASSIGN 


To remove from EMP all sales staff who made less than $100 
commission last month, enter: 


DELETE FROM EMP 
WHERE JOB = ‘SALESMAN’ 
AND COMM < 100 


DROP TABLE statement; FROM and WHERE clauses of SELECT 
statement. 
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DELETE (Embedded SQL) 


Purpose Remove rows from a table or view. The syntax of the embedded SQL 
DELETE statement differs from the standard SQL DELETE statement 
in the use of the AT clause, the FOR clause, the CURRENT OF clause, 
and the host variables. 


5-82 


Prerequisites You must own the table, have DELETE privilege for the table, or have 


DBA privilege. 


Syntax EXEC SQL [AT dbname] [FOR :host_integer] 
DELETE [FROM] table [alias] 
(WHERE {condition | CURRENT OF cursor} J 


Keywords and AT dbname 
Parameters 


FOR :host_integer 


FROM table 


alias 


WHERE clause 


condition 


cursor 
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is an optional clause that introduces the name of a 
non-default database connection, previously 
established with the DECLARE DATABASE 
statement. 


specifies a limit on the number of iterations of the 
DELETE statement when arrays are used in the 
WHERE clause. 


indicates the name of the table or view from which 
you want to delete rows. 


is an alias assigned to the table and is generally 
used in DELETE statements with correlated 
queries. 


is a search condition for the rows that are to be 
deleted. If the WHERE clause is omitted, all rows 
of the table or view are deleted. 


is a logical expression that may contain references 
to host variables or host arrays. Refer also to the 
syntax definition of condition in Chapter 4 
"Operators and Functions" of this Manual. 


is used to name a cursor that is defined ina 
DECLARE CURSOR statement. The cursor must 
be opened and positioned on a row before using 
the DELETE statement with the CURRENT OF 
clause. 


Usage Notes 


Examples 


Related Topics 


DELETE (Embedded SQL) 


If the host variables in the WHERE clause are arrays, the DELETE 
statement is executed once for each set of array components. Each 
execution of the DELETE statement may delete zero, one, or more rows. 


If any of the host variables used in the WHERE clause is an array, then 
all of the host variables in the WHERE clause must be arrays. The 
arrays may be of different sizes, but the number of array components 
processed is determined by the size of the smallest array. 


If no rows satisfy the condition, no rows are DELETEd and the 
SQLCODE returns a NOT_FOUND condition. 


The cumulative number of rows DELETEd is returned in SOLROWS. 
When arrays are used as in the WHERE clause, this count reflects the 
total number of DELETEs for all components of the array processed in 
the DELETE statement. 


If the WHERE clause is omitted, a warning flag is raised in the 5th 
component of SQLWARN (SQLCA). For a description of SQLCODE, 
ORACLE.SQLROWS, and the SQLCA, refer to the Programmer's Guide 
to the ORACLE Precompilers manual and the Supplement to the ORACLE 
Precompiler's Guide for your specific language. 


The following examples demonstrate the use of the DELETE statement: 


EXEC SQL DELETE FROM EMP 
WHERE DEPTNO = :deptno 
AND SAL :sal; 


EXEC SQL DECLARE Cl CURSOR 
FOR SELECT ...; 


EXEC SQL FETCH C1 
INTO ...3 


EXEC SQL DELETE FROM EMP 
WHERE CURRENT OF C1; 


DECLARE DATABASE and DECLARE STATEMENT statements. 
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DESCRIBE (Dynamic Embedded SQL; Method 4) 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topic 


Allocate and initialize a descriptor to hold the host variable 
descriptions from a SQL statement previously prepared ina PREPARE 
statement. 


You must PREPARE the SQL statement that contains the host variables 
to be DESCRIBEd. 


For bind variables: 


EXEC SQL DESCRIBE BIND VARIABLES FOR statement_name 
INTO descriptor_name 


For SELECT-list entries: 


EXEC SQL DESCRIBE [SELECT LIST FOR] statement_name 
INTO descriptor_name 


BIND is required to specify that the statement should 

VARIABLES describe input variables. 

SELECT LIST specifies that a output variable list should be 
described. The explicit use of this clause is 
optional. 

statement_name indicates a previously prepared SQL statement. It 
may contain valid references to host variable 
arrays. 

descriptor_name indicates the name by which the descriptor is 
referenced. 


The descriptor must be previously declared in the program. Output 
and input variables should not be included in the same descriptor. 


The DESCRIBE is generally executed after the PREPARE statement. 


For a language specific example, refer to the Supplement to the ORACLE 
Precompilers Guide for your specific programming language. 


PREPARE statement; Supplement to the ORACLE Precompilers Guide. 
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DROP CLUSTER 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topic 


Remove the specified cluster from the database. 
You must be the owner of the cluster or have DBA privilege. 


DROP CLUSTER [user.]cluster 
{INCLUDING TABLES] 


user is the owner of the cluster. 

cluster is the name of an existing cluster. 

INCLUDING will cause all tables that belong to the cluster to be 

TABLES dropped. If INCLUDING TABLES is not specified, 
the tables must have been dropped prior to 
dropping the cluster. 


You may not drop a cluster that was created by another user unless you 
have DBA privilege. 


Dropping a cluster also drops the cluster index and returns all cluster 
space, including index blocks, to the appropriate tablespace(s). 


Dropping a clustered table has the additional effect of removing it from 
the cluster. You cannot uncluster an individual table. To get the same 
result: 


1. Create a new table with the same structure and contents as the old 
one but with no CLUSTER option: 


CREATE TABLE new 
AS SELECT * FROM old 


2. Drop the old table: 
DROP TABLE old 
3. Finally, use RENAME to give the new table the name of the old one: 
RENAME new TO old 
Grants on the old clustered table do not apply to the new unclustered 
table and must be regranted. 
To drop a cluster named GEOGRAPHY along with all tables belonging 
to the cluster, enter: 
DROP CLUSTER GEOGRAPHY INCLUDING TABLES 
DROP TABLE statement. 
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DROP DATABASE LINK 
Purpose Remove the specified database link. 
Prerequisites | You must be the owner of the database link. You must have DBA 
privilege to drop a PUBLIC database link. 
Syntax DROP [PUBLIC] DATABASE LINK Link 
Keywords and PUBLIC must be specified to drop a PUBLIC database link. 
Parameters inf is the name of the database link to be dropped. 
Usage Notes _ If the link is public, PUBLIC must be specified; only DBAs may use the 
PUBLIC clause. If the link is private, PUBLIC must be omitted. 
A DBA may drop a PUBLIC database link owned by another DBA. 
Example To drop a database link named BOSTON: 
DROP DATABASE LINK BOSTON 
Related Topics CREATE DATABASE LINK statement; SQL*Net User's Guide for your 


specific SQL*Net protocol. 
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DROP INDEX 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Remove the specified index from the database. 
You must be the owner of the index or have DBA privilege. 


DROP INDEX [user.] index 

user is the name of the owner of the index. 

index is the name of the index to be dropped. 

You cannot drop an index created by another user unless you have the 


DBA privilege. When the index is dropped all blocks allocated to the 
index are returned to the index’s tablespace. 


User defaults to the username issuing the DROP. 


To drop an index named MONOLITH, enter: 
DROP INDEX MONOLITH 
ALTER INDEX, CREATE INDEX, and CREATE TABLE statements. 
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DROP ROLLBACK SEGMENT 
Purpose Remove the specified rollback segment. 
Prerequisites Requires DBA privilege. 
Syntax DROP [PUBLIC] ROLLBACK SEGMENT segnient 
Keywordsand PUBLIC must be specified for PUBLIC rollback segments. 
Parameters segment specifies the name of an existing rollback segment. 
Usage Notes Only rollback segments which are not in use can be dropped. Query 
the STATUS column of the DBA_ROLLBACK_SEGS Data Dictionary 
view to determine which rollback segments are in use. If the rollback 
segment is in use, you may either wait until all outstanding 
transactions using the rollback segment are complete, or you may 
SHUTDOWN the database IMMEDIATE and then STARTUP the 
database in EXCLUSIVE mode. 
All space allocated to the rollback space is retuned to the tablespace. 
Example To drop the public ACCOUNTING rollback segment, enter: 
DROP PUBLIC ROLLBACK SEGMENT ACCOUNTING 
Related Topics ALTER ROLLBACK SEGMENT, CREATE ROLLBACK SEGMENT, 


and CREATE TABLESPACE statements. 


5-88 SQL Language Reference Manual 


DROP SEQUENCE 
Purpose 


Prerequisites 
Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 





Remove the specified sequence. 
Must be the owner of the sequence or have DBA privilege. 


DROP SEQUENCE [user.] sequence 
user is the owner of the sequence. 


sequence is the name of the sequence to be dropped. 


User defaults to the username issuing the DROP. 


One method to restart an sequence is to drop and recreate it. For 
example, if you have a sequence that is at 150 and you would like to 
restart the sequence at 27, you would: 


1. Drop the sequence. 
2. Create it with the same name and a START WITH value of 27. 


To drop Elly’s ESEQ sequence, enter: 
DROP SEQUENCE ELLY.ESEQ 
ALTER SEQUENCE and CREATE SEQUENCE statements. 
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DROP SYNONYM 
Purpose 


Prerequisites 


Syntax 
Keywords and 
Parameters 


Usage Notes 


Example 


Related Topic 


Remove the specified synonym from the database. 


You must be the owner of the synonym to drop a private synonym. 
You must have DBA privilege to drop a public synonym or a synonym 
that you do not own. 

DROP [PUBLIC] SYNONYM [user.] synonym 

PUBLIC must be specified to drop a public synonym. 
synonym is the name of the synonym to be dropped. 

You cannot drop a private synonym created by another user unless you 
have DBA privilege. 

You may alter a synonym by dropping and recreating it. 

To drop a synonym named MARKET, enter: 


DROP SYNONYM MARKET 
CREATE SYNONYM statement. 
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DROP TABLE 
Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Remove the specified table and all its data from the database. 
You must be the owner of the table, or have DBA privilege. 


DROP TABLE [user.}table 
user is the owner of the table 
table is the name of the table to be dropped. 


You cannot drop a table created by another user unless you have DBA 
privilege. 

When you drop a table, ORACLE automatically drops indexes for the 
table, whether created by you or by another user, and privileges 
granted on the table. Views and synonyms that refer to the table are not 
dropped, but become invalid. You should drop them or redefine them, 
or (re)define other tables or views in such a way that the views and 
synonyms become valid again. Rows are effectively deleted from the 
table. 


All blocks allocated to the table are returned to the tablespaces 
containing the data and the indexes unless the table is a member of a 
cluster. 


You can drop all tables in a cluster by issuing the DROP CLUSTER 
statement with the INCLUDING TABLES clause and avoid dropping 
each table individually. 


Before dropping a table, you should use the USER_CROSS_REFS Data 
Dictionary view to determine whether any other tables depend on the 
existence of the table you are about to drop. 


To drop a table named TEST_DATA, enter: 
DROP TABLE TEST _DATA 


DROP CLUSTER, ALTER TABLE, CREATE INDEX, and 
CREATE TABLE statements. 
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DROP TABLESPACE 


Purpose 


Prerequisites 
Syntax 


Keywords and 


Parameters 


Usage Notes 


Examples 


Related Topics 


Remove the specified tablespace, optionally removing all the 
tablespace’s database objects, such as tables. 


Requires DBA privilege. The tablespace may be online or offline. 


DROP TABLESPACE tablespace 
{INCLUDING CONTENTS] 


tablespace specifies the name of an existing tablespace. The 
SYSTEM tablespace may not be dropped. 

INCLUDING specifies that the tablespace is to be dropped even 

CONTENTS if it contains data. If the argument is omitted and 


the tablespace is empty, the tablespace is dropped. 


If the argument is omitted and the tablespace has 
contents, the tablespace is not dropped. 


You should take the tablespace offline before dropping it since the 
tablespace can not be dropped while users are accessing a tablespace’s 
data, index, rollback or temporary segments. 


To drop the MFRG tablespace and all its contents, enter: 


DROP TABLESPACE MIFRG 
INCLUDING CONTENTS 


ALTER TABLESPACE, CREATE DATABASE, and 
CREATE TABLESPACE statements. 
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| DROP VIEW 
| Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 





Remove the specified view from the database. 
You must be the owner of the view or have DBA privilege. 


DROP VIEW [user.]view 
user is the owner of the view. 
view is the name of an existing view. 


You may drop a view created by another user if you have the DBA 
privilege. 


When you drop a view, views and synonyms that refer to the view are 
not dropped, but become invalid. You should drop them or redefine 
them, or (re)define other tables or views in such a way that the views 
and synonyms become valid again. Grants on the view are dropped, 
however. 


You may “alter" a view by dropping and recreating it. 

Before dropping the view, you may use the USER_CROSS_REFS Data 
Dictionary view to determine whether other tables and views depend 
on the view you are about to drop. 

To drop a view named VIEW_DATA, enter: 

DROP VIEW VIEW_DATA 


CREATE TABLE, CREATE VIEW, and CREATE SYNONYM 
statements. 
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EXECUTE (Dynamic Embedded SQL: Method 2) 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Example 


Related Topics 


Execute an INSERT, DELETE, or UPDATE statement that has been 
previously prepared in a PREPARE statement. The statement may 
reference input host variables supplied in the USING clause. 


You must PREPARE the statement before execution. 


EXEC SQL [AT dbname] {FOR shost_integer] 
EXECUTE statement name 
[USING values list] 


AT dbname provides the name of a non-default database 
connection. 


FOR :host_integer — specifies a limit on the number of iterations of the 
EXECUTE statement when arrays are used in the 


WHERE clause. 

statement_name is the name of the prepared statement you want to 
execute. This name cannot be the name of a 
SELECT statement. 

USING provides a list of host variables, literals, or 


expressions that are substituted as input host 
variables into a previously prepared statement. 
Note that if any host variables are arrays, then all 
of the components in the USING clause must be 


host variable arrays. 
values_list values_element [,values_element...] 
values_element host_variable[:indicator] | literal | expression 


The following example demonstrates the use of the EXECUTE 
statement: 

my_own_statement : string(1.. 100); 

my_var : float; 


get (my, own_statement); 


EXEC SQL PREPARE s FROM :my_own_statement; 
BXEC SQL EXECUTE s USING :my_var; 
PREPARE statement; the Programmer's Guide to the ORACLE 


Precompilers manual and the Supplement to the ORACLE Precompilers 
Guide for your specific language. 


SQL Language Reference Manual 





ER 
EXECUTE IMMEDIATE (Dynamic Embedded SQL: Method 1) 


Purpose 


Prerequisites 
Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Prepare and execute a SQL statement containing no host variable 

references. 

None. 

EXEC SQL [AT dbname] 

EXECUTE IMMEDIATE (:host_string | string literal} 

AT dbname optional clause specifying a non-default database. 

shost_string host variable, represents the SQL statement to be 
executed. 

string_literal string literal containing the text of a SQL statement 
to be executed. 

The EXECUTE IMMEDIATE statement accepts either a literal character 


string or a host variable containing the text of a SQL statement, and 
creates an executable form of the SQL statement. Next, it executes the 
SQL statement and destroys the executable form. 


When an EXECUTE IMMEDIATE statement is executed, the specified 
statement is parsed and checked for errors. If the statement is not a 
valid SQL statement, it is not executed and the error condition that 
makes it invalid is reported in the SQLCODE. If the statement is valid 
syntactically but results in an error during execution, the error is also 
reported in the SQLCODE. 


The EXECUTE IMMEDIATE statement is most useful for a SQL 
statement that is executed only once. You should use the PREPARE and 
EXECUTE method for statements that are executed multiple times, 
because a PREPAREd statement does not incur the overhead of parsing 
each time it is executed. 


get (my_string) 
EXEC SQL EXECUTE IMMEDIATE :my_string 


EXEC SQL EXECUTE IMMEDIATE "DELETE FROM EMP WHERE EMPNO = 9460" 
PREPARE and EXECUTE statements. 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Determines the execution plan that ORACLE follows to execute a 
specified SQL statement. Inserts rows describing each step of the plan 
into a specified table. 


You must own or have INSERT privilege on the table that you specify 
to hold the rows of the execution plan. 


EXPLAIN PLAN 
{SE STATEMENT ID = char] 
{INTO [user.]table} 
FOR sql_statement 


SET specifies the value of the STATEMENT_ID column 

STATEMENT_ID _ for the rows of the execution plan in the output 

= char table. If you omit the SET clause, the 
STATEMENT ID value for these rows defaults to 
NULL. 


INTO [user.Jtable identifies the output table. The user is the table’s 
owner, The default user is the user issuing the 
EXPLAIN PLAN statement. The table is the name 
of the output table, The default table is 
PLAN_TABLE. 


FOR sql_statement _ is the text of a SELECT, INSERT, UPDATE, or 
DELETE statement. The EXPLAIN PLAN 
statement generates the execution plan for this 
sql_statement. 


Before you issue the EXPLAIN PLAN statement, you must create the 
output table. You can create a sample output table named 
PLAN_TABLE with the SQL script XPLAINPL.SQL available on your 
distribution media. If you want to use another output table, that table 
must have the same column names and datatypes as PLAN_TABLE. 
For information on the location of XPLAINPL.SQL on your operating 
system, refer to your Installation and User's Guide. 


After you issue the EXPLAIN PLAN statement, you can identify the 
rows of the execution plan in PLAN_TABLE by the value in the 
STATEMENT_ID column. For the rows of an execution plan, this 
value is the value of the STATEMENT_ID parameter in the SET clause. 
Since the value of this parameter defaults to NULL, you should be sure 
to assign this value in the SET clause, especially if your PLAN_TABLE 
contains rows of many execution plans. 
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Example 


Related Topics 


EXPLAIN PLAN 


You can also issue the EXPLAIN PLAN statement as part of the SQL 
trace facility. 

For information on how to interpret the execution plan, refer to 
Chapter 7 "Performance Diagnostic Tools" of the ORACLE RDBMS 
Performance Tuning Guide. 


Consider this EXPLAIN PLAN statement: 


EXPLAIN PLAN 
SET STATEMENT_ID = ‘RAISE_IN_CHICAGO’ 
INTO OUTPUT 
FOR UPDATE EMP 
SET SAL = SAL * 1.10 
WHERE DEPTNO = 
(SBLECT DEPTNO 
FROM DEPT 
WHERE LOC = ‘CHICAGO’ ) 


This EXPLAIN PLAN statement performs these functions: 


« determines the execution plan for the specified SELECT statement 
* inserts rows describing the execution plan into the specified 
OUTPUT table 
* assigns the value “RAISE_IN_CHICAGO’ to the 
STATEMENT_ID column of the rows 
This SELECT statement queries the OUTPUT table and returns the 
execution plan: 


SELECT OPERATION, OPTIONS, OBJECT_NAME 
FROM OUTPUT 
WHERE STATEMENT ID = ‘RAISE _IN_CHICAGO’ 


The query returns this execution plan: 


OPERATION OPTIONS OBJECT_NAME 
FILTER 

TABLE ACCESS FULL EMP 

TABLE ACCESS FULL DEPT 


Chapter 7 "Performance Diagnostic Tools" of the ORACLE RDBMS 


’ Performance Tuning Guide. 
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FETCH (Embedded SQL) 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Retrieve one row from the database. The FETCH embedded SQL 
statement positions the cursor on the next row to be retrieved and 
assigns the values of the current row to the referenced host variables. 


You must first OPEN the cursor that contains the SQL SELECT 
statement. For dynamic SQL, you must first PREPARE the statement 
and possibly set up descriptors for the statement before the OPEN. 


EXEC SQL (FOR :host_integer] 
FETCH cursor_name 
INTO host_variable list 


For Dynamic SQL, Method 4: 


EXEC SQL [FOR shost_integer] 
FETCH cursor_name 
USING descriptor 


FOR :host_integer _ limits the maximum number of rows to FETCH 
into the output variables. 


cursor_name indicates the name of a cursor that is defined by a 
DECLARE CURSOR statement. The DECLARE 
CURSOR statement must precede the FETCH 
statement within the program. 


INTO This clause identifies host variables that are 

host_variable_list declared within the program. If any host variable 
is an array then all host variables in the INTO 
clause must be arrays. 


host_variable_list is a set of one or more output host_variables 
separated by commas (each optionally associated 
with an indicator variable) 


descriptor is the name of the descriptor as referenced ina 
previous DESCRIBE statement. 


The cursor must be declared and opened. The cursor must be open 
when the FETCH statement is executed. Refer to the OPEN statement 
later in this chapter. 


The SELECT statement associated with the query may not include an 
INTO clause; rather, the INTO clause and list of output host variables 
are included in the FETCH statement. 
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Example 


Related Topics 


FETCH (Embedded SQL) 


The FETCH statement reads the rows of the active set and names the 
output variables which contain the results. Indicator values are set to 
-1 if their associated host variable is null, 


The number of rows retrieved is determined by the dimensions of the 
output variables in the FETCH and the value of the optional FOR 
variable. For example, if an output variable is declared as an array of 
size 100, ORACLE will attempt to FETCH 100 rows. The FOR clause 
can be used to limit the FETCH to 75 rows. 


If there are rows remaining in the table, the cursor is positioned on the 
next row, and values are assigned to host variables as specified by the 
INTO clause of the FETCH and/or the USING clause of the OPEN 
CURSOR statement. 


If the cursor is currently positioned on or after the last row of the table, 
the SQLCODE is set to +100 (or +1403 if in Version 5 compatibility 
mode). In this case, if null values are FETCHed, the value of the 
corresponding host variable is not changed. 


Note that no AT clause is associated with the FETCH statement, The 
database referenced by the cursor is specified in the DECLARE 
CURSOR statement. 


FETCH only moves forward through the set of rows that satisfy the 
SQL statement. If you need to revisit any of the previously fetched 
rows, you must re-open the cursor and FETCH each row in turn. 


The following example illustrates the use of the FETCH statement. 
BXEC SQL FETCH my_cursor INTO :empno, :ename 


PREPARE, DECLARE CURSOR, OPEN cursor, and CLOSE cursor 
statements, 
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FOR clause (Embedded SQL) 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Limit the number of repetitions for array processing in SELECT, 
UPDATE, DELETE, INSERT, FETCH, and EXECUTE statements. 


None. 


FOR zshost_integer 


FOR :host_integer When the FOR clause is used, the statement is 
executed as many times as the minimum of the 
value of host_integer and the sizes of the relevant 
arrays (including indicator variable arrays). 


The FOR clause is optional. The host variable arrays may be of different 
sizes. If the FOR clause is omitted, the size of the smallest array is used 
to specify the number of components processed. 


The following example demonstrates the use of the FOR clause: 


limit: constant integer := 200 
ename_1 : name_array (1... 100) -- Note: arrays may 
ename_2 : name_array (1 ... 50) -- have different sizes 
EXEC SQL FOR :limit 
DELETE FROM EMP -~ The number of times 
WHERE ENAME = :ename_1 -- the delete is 
AND ENAME = :ename_ 2 -- executed is 50 


EXECUTE and FETCH statements. 
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GRANT (Form I) 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Provide access to the database. 


Requires DBA privilege, except any user may use the GRANT 
statement to change his or her own password. 


GRANT database_priv [,database_priv] -.. 
TO user [,user] ... 
{ IDENTIFIED BY password [,password] ...] 


database_prio specifies one or more of the following database 
privileges: 


« DBA 


¢ CONNECT 
« RESOURCE 


user specifies either a new or existing database 
username. If the name already exists in the 
database, then this statement is used to add 
database privileges. If the name does not already 
exist, it is added to the Data Dictionary with the 
database privileges specified. 


password specifies a password for each username specified. 
The list of usernames and passwords must be 
equal in number if multiple users are specified. A 
password may be used to provide new passwords 
to new users or to change the password of an 
existing user. A password need not be specified 
if the GRANT statement is being used to add 
privileges to an existing user. A password must 
follow the standard rules for naming database 
objects. 


The CONNECT privilege establishes a new username in the database. 
With CONNECT privilege a user may connect to the database and 
operate on any objects to which he has been given privilege. For 
example, all users may select from the data dictionary view 
DICTIONARY. A user may create views, synonyms and database links 
with the CONNECT privilege. 


The RESOURCE privilege permits a user to create database objects 
including tables, indexes, clusters, and sequences. This form of GRANT 
RESOURCE provides unlimited resource for all tablespaces. Use Form 
II to GRANT RESOURCE on specific tablespaces. 
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GRANT 


(Form I) 


Examples 


Granting Authority 


toa User 


Granting DBA 


Authority 


Changing 
Password 


Your 


Related Topics 


The DBA privilege allows the user to bypass many standard privileges 
normally required to use database objects. The DBA privilege also 
permits the user to perform certain database administration tasks, such 
as the CREATE TABLESPACE and CREATE ROLLBACK SEGMENT 
statements. 
With the DBA privilege, a user may: 

* SELECT from any table or view 

* CREATE database objects for other users 


+ DROP other user’s database objects including tables, views, 
synonyms, and database links 


+ GRANT various database privileges 
* CREATE public synonyms and database links 
* run full database exports and imports. 


If you are a DBA, you can grant access and table-creation authority to a 
user named SCOTT, with the password TIGER, by entering: 


GRANT CONNECT, RESOURCE TO SCOTT IDENTIFIED BY TIGER 


SCOTT may now create objects in any tablespace. 


To grant the DBA privilege to an existing user named SCOTT, enter: 
GRANT DBA TO SCOTT 

A password need not be specified in this statement because SCOTT is 
an existing user. 

If your user name is SCOTT, you could change your password to 
COWSLIP by entering: 

GRANT CONNECT TO SCOTT IDENTIFIED BY COWSLIP 

ALTER USER and REVOKE statements. 
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GRANT (Form IT) 
Purpose 


Prerequisite 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Provide access to database space (tablespaces) with the option of 
imposing a limit on the amount of space an individual user can use. 


Requires DBA privilege. 


GRANT RESOURCE [ (quota [KiM]) ] 
ON tablespace 
TO { PUBLIC | user [,user}]...} 


RESOURCE specifies that the list of users can create objects in 
the specified tablespace. 
quota is specified as an integer and represents the 


number of bytes of space within the tablespace 
that the user may allocate. No quota means an 
unlimited tablespace resource. The use of zero (0) 
revokes quota or RESOURCE privilege on the 
tablespace. If the quota is followed by K, then the 
quota is computed as the quofa multiplied by 1024. 
If M is used, then the quota will be the quota 


multiplied by 1048576. 
tablespace specifies the name of an existing tablespace. 
user specifies an existing username. The keyword 


PUBLIC may be used to grant the resource 
privilege to all database users. 


Form II of the GRANT statement provides additional flexibility and 
control as compared to Form I of the GRANT statement. The use of 
Form II is preferred so that DBAs can have additional control over how 
database space is allocated. ; 


If you are a DBA, you can grant the ability to create objects that occupy 
a maximum of 10 megabytes of space in the FINANCE tablespace to 
SCOTT by entering: 


GRANT RESOURCE (10M) ON FINANCE T0 SCOTT 
ALTER USER, REVOKE, and CREATE SEQUENCE statements. 
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GRANT { object_priv [, object_priv ] ... 


Provide various types of access to database objects, such as tables, 


You must own the database object or have been granted privileges on 


| ALL [PRIVILEGES] } 


TO { user | PUBLIC } [,user] ... 


for tables, is one of: ALTER, DELETE, INDEX, 
INSERT, REFERENCES, SELECT or UPDATE. 


for views, is one of: DELETE, INSERT, SELECT, or 
UPDATE. 


for sequences, is either ALTER or SELECT. 


The UPDATE and REFERENCES privileges can 
restrict updates and references to specific columns. 
The syntax for granting column privileges is: 
GRANT column_priv [, column_priv] 
(column [,column] ...) 

ON [user.] table 

TO { user | PUBLIC } [,user] ... 

( WITH GRANT OPTION ] 


specifies a column from the table. 


represents all of the privileges specified by 
object_priv. 

specifies the table, view, sequence, or synonym on 
which the privileges are granted. 


specifies the user(s) to which the privileges are 
granted. 


represents all users within the database and is 
used to grant privileges to all users, present and 


specifies that the grantee may pass on the 
privileges that he has been granted to another user. 


GRANT (Form III) 
Purpose 
views, and sequences. 
Prerequisites 
the object with GRANT OPTION. 
Syntax 
ON [user.]object 
[ WITH GRANT OPTION ] 
Keywords and — object_priv 
Parameters 
column 
ALL PRIVILEGES 
ON [user.] object 
TO user 
PUBLIC 
future. 
WITH GRANT 
OPTION 
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Usage Notes 


Sequences 


GRANT (Form TI) 


The table owner always has all privileges on the table. 
ALTER is the privilege to use the ALTER TABLE statement. 
DELETE is the privilege to delete rows from the table. 
INDEX is the privilege to create an index on a table. 
INSERT is the privilege to insert rows into the table. 


REFERENCES is the privilege to refer to the table within a table or 
column constraint. 


SELECT is the privilege to query the table. To restrict SELECT on 
particular columns, create a view on the table with only those columns 
and grant SELECT on the view. 


UPDATE is the privilege to update rows in the table. If columns are 
specified, then only those columns may be updated. 


The privileges granted to specific users are independent of those 
granted to PUBLIC. For example, if SCOTT granted SELECT on the 
EMP table to BLAKE and PUBLIC and then SCOTT revoked SELECT 
on the EMP table from PUBLIC, BLAKE would still have access to EMP 
(even though BLAKE is a member of PUBLIC). 


You may limit access to a table by first creating a view on the base table 
and then by granting access to the view and not to the base table. 


GRANTs on synonyms are converted to GRANTS on the base table 
referenced by the synonym. 


To use a sequence, a user other than the owner must have been granted 
the SELECT privilege. The ALTER privilege is for the ALTER 
SEQUENCE statement, A user may pass his sequence privileges to 
another user if he has been granted the WITH GRANT OPTION 
privilege. 

ORACLE is able to determine that you are granting access to a 
sequence as opposed to a table because all objects (including sequences, 
tables, views, indexes, and clusters) owned by a user must have distinct 
names. 
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GRANT (Form IID) 


5-106 


Example 


Sequence Example 


Related Topics 


To grant full access authority on the table BONUS to a user named 
JONES, including the ability to grant these privileges to other users, 
enter: 


GRANT ALL ON BONUS TO JONES WITH GRANT OPTION 
To authorize any user to query or update a table of golf handicaps, 
enter: 

GRANT SELECT, UPDATE ON GOLF_HANDICAP TO PUBLIC 

To authorize user BLAKE to update and reference the SAL and COMM 
columns of the EMP table, enter: 


GRAN? UPDATE, REFERENCES (SAL, COMM) 
ON EMP 
TO BLAKE 


To grant access on ELLY’s ESEQ sequence to BLAKE, ELLY would 
enter: 


GRANT SELECT ON ESEQ TO BLAKE 


BLAKE could then generate a number from ELLY’s sequence with the 
following statement: 


SELECT ELLY.ESEQ.NEXTVAL FROM DUAL 
REVOKE statement. 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Add new rows to the specified table or to the table underlying the 
view. 


You must own the table, or have INSERT privilege for the table, or 
have DBA privilege. 


INSERT INTO {user.]Jtable [ (column [,column] ...) ] 
{ VALUES (value (,value]...) { query } 


user is the username for the owner of the table or view. 

table is a name of an existing table, view, or synonym. 
The default user is the user entering the INSERT. 

column is a column within the table or view. 

value is a value that corresponds by position to the list of 


columns. A value can be any expression. Unless 
value is NULL, it must match its column’s datatype. 


query isa SELECT statement that returns as many values 
as are listed in the column list. It cannot have an 
ORDER FOR nor FOR UPDATE clause. 


The INSERT statement used with the VALUES keyword always adds 
just one row. The fields in the specified columns (or all columns) are 
assigned the specified values. Columns not specified in the column list 
are assigned NULL and must not have been declared NOT NULL. 


The INSERT statement used with query instead of VALUES clause may 
add multiple rows (all those returned by the query). After the query has 
been processed, the columns in its result are matched by position to the 
columns specified after INSERT (or to all columns, if none are specified). 
The query may reference the target table. 


All columns that are defined NOT NULL must be supplied a value. 
Currently, all columns default to null. 


Ifa parenthesized list of columns is given, values must be provided for 
those columns; if not, values must be provided for all columns. In the 
case in which a parenthesized list of columns is not specified, the values 
provided are matched to the table’s column based on the internal 
position of the columns within the table. The position of each column 
within the table can be determined by selecting from the 
USER_TAB_COLUMNS Data Dictionary view. 


No rows will be inserted if the subquery of an INSERT... SELECT 
returns no rows. 
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INSERT 


Examples 


Related Topics 


To insert a new row into the table DEPT, enter: 
INSERT INTO DEPT VALUES (50, ‘PRODUCTION’, ‘SAN FRANCISCO’) 


To insert a row with six columns into the table EMP, including a NULL 
value and a number in scientific notation, enter: 


INSERT INTO EMP (EMPNO, ENAME, JOB, SAL, COMM, DEPTNO} 
VALUES (7890, ‘JINKS’, *CLERK’, 1.2E3, NULL, 40) 


To copy managers and presidents or employees whose commission 
exceeds 25% of their salary into the table BONUS, enter: 


INSERT INTO BONUS 
SELECT ENAME, JOB, SAL, COMM 
FROM EMP 
WHERE COMM < 25 * SAL 
OR JOB IN (/PRESIDENT’, ‘MANAGER’ ) 


DELETE and UPDATE statements. 
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INSERT (Embedded SQL) 
Purpose Add rows toa table. 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Must own the table, or have INSERT privilege for the table, or have 


DBA privilege. 
EXEC SQL [AT dbname] [FOR :host_integer] 
INSERT INTO [user.} table [ (column [,column)...) ] 
{ VALUES (values_element [,values_element}... ) | query } 
AT dbname is an optional clause that names a non-default 


FOR :host_integer 
[user.] table 


column 


VALUES 


values_element 


query 


database. 


limits the maximum number of array components 
processed by the INSERT operation. 


is aname of an existing table, view, or synonym. 
The default user is the user entering the INSERT. 


is a column within the table or view. Each of the 
specified columns must belong to a table specified 
in the INTO clause. 


introduces one row of values to be inserted. The 
values of the row are the values of the keywords, 
constants, SQL expressions, or host variables 
specified in the clause. Each host variable specified 
asa value must be declared in the program as a 
variable. The number of values in the VALUES 
clause must equal the number of names in the 
column list. 


can be either: 
* ahost variable with optional indicator variable 
* any expression 


is a SELECT statement that returns as many values 
as are listed in the column list. It cannot have an 
ORDER FOR nor FOR UPDATE clause. 


If the host variables in the VALUES list are arrays, the statement is 
executed as many times as the minimum of the sizes of the arrays (if 
different) and the value of the FOR parameter. 


If the WHERE clause returns no rows, then no rows will be inserted 
and the SQLCODE is set to +100 (+1403 in Version 5 compatibility 


mode). 
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INSERT (Embedded SQL) 


Compatibility Mode 


§-110 


Related Topics 


The ANSI standard specifies a return code of +100 for "end of fetch". 
The Version 6 default is +100. For a description of the Version 5 
compatibility mode option which forces ORACLE to return +1403, refer 
to the Programmer's Guide to the ORACLE Precompilers manual . 


The following examples illustrate the use of INSERT: 


EXEC SQL FOR :array_size INSERT INTO EMP (ENAME, EMPNO, SAL) 
VALUES (:ename, :empno, :sal); 


EXEC SQL INSERT INTO new emp (ENAME, EMPNO, SAL) 
SELECT ENAME, EMPNO, SAL FROM EMP 
WHERE DEPTNO = :deptno; 


EXECUTE statement; FOR clause. 
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LOCK TABLE 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Manually override automatic locking in order to lock one or more 
tables in the specified mode, enabling you to share or deny access to a 
table for the duration of your operation. 


Must own the table, have DBA privilege, or have been granted ALTER, 
DELETE, INSERT, SELECT or UPDATE on the table. 


LOCK TABLE [user.]table [, [user.]table ]... 
IN lockmode MODE [NOWAIT] 

user is the owner of the table. 

table is an existing table to which you have access. 

lockmode is one of: ROW SHARE, ROW EXCLUSIVE, 
SHARE UPDATE, SHARE, SHARE ROW 
EXCLUSIVE or EXCLUSIVE. 

NOWAIT specifies that ORACLE should not wait for the 


table if the table has been locked by another user. 
Instead, ORACLE will return control to the user. 


Exclusive locks allow queries on the locked table but prohibit any other 
activity on it. 


Share locks allow concurrent queries but prohibit updates to a table. 
Row Share locks allow concurrent access to a table. They prohibit users 


from locking the entire table for exclusive access. ROW SHARE is 
synonymous with SHARE UPDATE. 


Row Exclusive locks are the same as ROW SHARE locks, but also 
prohibit locking in SHARE mode. Row Exclusive locks are 
automatically obtained when updating, inserting, or deleting. 


Share Row Exclusive locks are used to look at a whole table and to allow 
others to look at rows in the table but to prohibit others from locking 
the table in SHARE mode or updating rows. 


Share Update locks are synonymous with ROW SHARE and included 
for compatibility with earlier versions of the ORACLE RDBMS. 
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LOCK TABLE 
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Example 


Related Topics 


Some forms of locks may be placed on the same table at the same time, 
other locks only allow one lock per table. For example, multiple users 
may place SHARE locks on the same table at the same time, but only 
one user may place an EXCLUSIVE lock ona table at a time. Fora 
complete description of the interaction of lock modes, refer to Chapter 
12 "Consistency and Concurrency" of the ORACLE RDBMS Database 
Administrator's Guide. 


When you lock a table, you can choose how different users may access 
it. Once locked, the table remains locked until your transaction 
commits or rolls back. 


If a LOCK TABLE request cannot be honored, for example because 
another user has already locked the table, LOCK TABLE either waits 
until the request can be honored or returns control to the user if 
NOWAIT is specified. If NOWAIT is specified and the resource has 
already been allocated to another user, then ORACLE will return an 
error and return control to the user. 


A lock never prevents other users from querying the table. A query 
never places a lock ona table. Thus, readers never block writers and 
writers never block readers. 


A lock ona view translates to a lock on the base table(s). 


To lock the table EMP in exclusive mode (but not wait if another user 
already has locked the table), enter: 


LOCK TABLE EMP IN EXCLUSIVE MODE NOWAIT 


DELETE, INSERT, UPDATE, COMMIT, ROLLBACK, and SAVEPOINT 
statements; Chapter 12 "Consistency and Concurrency" of the ORACLE 
RDBMS Database Administrator's Guide. 
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NOAUDIT (Form 1) 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Partially or completely reverse the effect of a prior system AUDIT 
statement. 


This form of NOAUDIT requires DBA privilege. 


NOAUDIT {system_option [,system_option]... { ALL} 
(WHENEVER [NOT] SUCCESSFUL] 
system_option is one of the following system options: CONNECT, 
DBA, NOT EXISTS, or RESOURCE. 
ALL represents all of the system options. 
WHENEVER specifies that auditing should be turned off for 
[NOT] successful or unsuccessful system accesses. If no 


SUCCESSFUL WHENEVER clause is used, auditing is turned off 
for both successful and unsuccessful accesses, 


See the AUDIT statement for a complete description of the system 
options, 


To stop the auditing of successful resource requests, enter: 
NOAUDIT RESOURCE WHENEVER SUCCESSFUL 
AUDIT Form I and GRANT statements. 
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NOAUDIT (Form ID) 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Examples 


Related Topics 


Partially or completely reverse the effect of a prior AUDIT statement, 
or of the DEFAULT table auditing option. 


You must own the object that NOAUDIT operates on. You must have 
DBA privilege to change the auditing options set for DEFAULT. 


NOAUDIT {option [,option]... | ALL} 
ON { object | DEFAULT } 
(WHENEVER [NOT] SUCCESSFUL] 


option For tables ALTER, AUDIT, COMMENT, DELETE, 
GRANT, INDEX, INSERT, LOCK, RENAME, 
SELECT, or UPDATE. 


For views AUDIT, DELETE, GRANT, INSERT, 
LOCK, RENAME, SELECT, or UPDATE. 


For sequences ALTER, AUDIT, GRANT, or 
SELECT. 


For synonyms, the applicable options are the same 
set of options for the table or view on which it is 


based. 
ALL represents all valid options. 
object is an existing table, view, or sequence you own. 
DEFAULT references the default auditing options set by the 


DBA to define auditing options for new tables. 
DEFAULT does not apply to views or sequences. 


WHENEVER specifies that auditing should be turned off for 

[NOT] either successful or unsuccessful accesses to the 

SUCCESSFUL table. If this clause is omitted, auditing is turned off 
for both successful and unsuccessful accesses. 


NOAUDIT causes ORACLE to stop auditing the use of a table or view. 
Asa DDL statement, the NOAUDIT statement also commits the 
current transaction. 


To stop the auditing of attempted UPDATEs on the table EMP, enter: 
NOAUDIT UPDATE ON EMP 

To stop all auditing of sessions of unsuccessful uses of EMP, enter: 
NOAUDIT ALL ON EMP WHENEVER NOT SUCCESSFUL 

AUDIT Form II and GRANT statements. 
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(eS 
OPEN cursor (Embedded SQL) 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Allocate an ORACLE cursor for a previously declared explicit cursor. 
Then, evaluate the query referenced in the cursor declaration and 
substitute the host variable names supplied in the USING clause into 
the WHERE clause of the query. 


Must DECLARE the cursor before OPENing it. 


EXEC SQL OPEN cursor_name {USING host _variable_list] 


For Dynamic SQL Method 4, use: 
EXEC SQL, OPEN cursor name [USING DESCRIPTOR name] 


cursor_name indicates a cursor that has been previously 
declared in a DECLARE CURSOR statement. 
Refer to the DECLARE CURSOR statement earlier 
in this chapter. 

USING lists the host_variables to be substituted into the 

hostvariable_list statement referenced in the DECLARE CURSOR 
statement. The substitution is based on position; 
the variable names in the USING clause are 
typically different from the variable names in 
the PREPARE statement. 


descriptor_name references the result of a previous DESCRIBE 
statement. 


OPEN cursor defines the active set of rows and initializes the cursor to 
the beginning of the active set. The values of the host variables at the 
time of the OPEN are substituted in the statement. The OPEN cursor 
statement is valid only when embedded in an application program. 


All cursors in a program are in a closed state when the program is 
initiated or when they have been explicitly closed using the CLOSE 
statement. 

The OPEN cursor statement allocates the cursor and positions it just 


before the first row of the active set. No rows are actually retrieved at 
this point; this is done by the FETCH statement. 


Once you have opened a cursor, its input host variables are not 
reexamined until you re-open the cursor. To change any input host 
variables and therefore the active set, you must re-open the cursor. 
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OPEN cursor (Embedded SOL) 
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Example 


Related Topics 


You can re-opened a cursor without first closing it. This may save 
reparsing if the statement has not been changed. For more information, 
refer to the Precompiler options HOLD_CURSOR and 
RELEASE_CURSOR in the Programmer's Guide to the ORACLE 
Precompilers manual. 


When used in Dynamic SQL Method 4, the DESCRIBE statement, the 
host variables referenced by the named descriptor are substituted into 
the SQL statement referenced in the cursor declaration. 


The example that follows shows the typical sequence when using the 
OPEN cursor statement. You must declare the cursor, open the cursor, 
fetch, and finally, close the cursor: 


EXEC SQL DECLARE c CURSOR 
FOR SELECT ename, empna, job, sal 
FROM emp 
WHERE deptno=30; 


EXEC SQL OPEN c; 


example: Loop 
EXEC SQL FETCH c INTO :ename, :empno, :job, :sal:sal_ind; 


if sqlca.sqlcode = oracle.error.not_found then 
exit loop example; 
end if; 


end loop example; 


BXEC SQL CLOSE ¢; 


PREPARE, DECLARE CURSOR, FETCH, and CLOSE cursor 
statements. 
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PREPARE (Dynamic Embedded SQL) 


Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Parses a SOL statement from a host variable character string. 


None. 


EXEC SQL PREPARE statement_name 
FROM {:host_string|string_literal} 


statement_name 


shost_string 


string_literal 


references the PREPAREd statement. If this name 
has already been assigned to an existing prepared 
statement, the prior assignation will be super- 
ceded. This name is an identifier used by 
ORACLE; it is not a host variable. 


is a host variable containing the text of any valid 

SQL statement to be prepared for execution. The 

host_string can be of type varchar, type string, or 
an access type to varchar or string. 


is a string literal containing the text of a SQL 
statement. 


The PREPARE statement parses the SQL statement and gives it a 
statement name. The SQL statement is not preceded by the EXEC SQL 
clause, although the PREPARE statement itself is. The statement can be 
a SELECT statement with a FOR UPDATE OF clause. Refer to the 
SELECT statement later in this chapter. 


The variables referenced in the host_string are placeholders. The actual 
host_variable names are assigned in the USING clause of the OPEN 
cursor statement (input host variables) or in the INTO clause of the 
FETCH statement (output host variables). The substitution is based on 


position. 


A SQL statement is prepared only once, but can be executed any 


number of times. 


The following example illustrates the use of PREPARE: 


my_string : string(1..80); 


get (my_string); 


EXEC SQL PREPARE s FROM :my_string; 


EXEC SQL EXECUTE s; 


DECLARE CURSOR, OPEN cursor, FETCH and CLOSE cursor 


statements. 
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Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Rename a table, view, or synonym. 
Must own the table, view, or synonym to be renamed. 


RENAME old TO new 


old is the current name of the table, view, or synonym. 
new is the intended name of the table, view, or 
synonym. 


This statement changes the name of a table, view, or synonym from old 
to new. The old value is the name of the object to be changed and the 
new value is the name to change it to (assuming new is not already in 
use by another object and is a valid name for ORACLE objects). 
Grants and indexes belonging to the old object are transferred to, the 
new object. 

Columns may not be renamed with this command. One method of 
renaming columns is to use the CREATE TABLE... AS SELECT 
statement. For example, a table, STATIC, with only one column, 
OLDNAME could be recreated with its column named NEWNAME 
with the following statements: 


CREATE TABLE TEMPORARY (NEWNAME) 
AS SELECT OLDNAME FROM STATIC 


DROP TABLE STATIC 
RENAME TEMPORARY TO STATIC 


To change the name of table DEPT to EMP_DEPT: 
RENAME DEPT TO EMP_DEPT 


CREATE SYNONYM, CREATE TABLE, and CREATE VIEW 
statements. 


SQL Language Reference Manual 


REVOKE (Form I) 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topic 


Revoke database privileges from one or more users. 
Requires DBA privilege. 


REVOKE { [CONNECT] [,RESOURCE] [,DBA] } 
FROM user [,user] ... 


user is an existing user. 

CONNECT, is the privilege to be revoked from user. 
RESOURCE, CONNECT, RESOURCE, and DBA have the same 
DBA meanings as in GRANT. 


REVOKE returns success even when there are no privileges to revoke. 


REVOKE does not affect any objects owned by the user. For example, 
the REVOKE of CONNECT from a user named BLAKE would not 
affect BLAKE’s SALES table. Other users who had previously been 
granted access to BLAKE’s SALES table may continue to access the 
table. If BLAKE is regranted access to the database, he will once again 
own the SALES table. It is therefore recommended that you drop all 
objects owned by a user before revoking CONNECT from that user. 


To revoke RESOURCE authority from users named SCOTT and 
JOLLY_ROGER enter: 


REVOKE RESOURCE FROM SCOTT, JOLLY_ROGER 
AUDIT and GRANT statements, 
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REVOKE (Form II) 


Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Revoke space privilege from a specific tablespace. 
Requires DBA privilege. 


REVOKE space_privilege ON tablespace 
FROM user [,user}] ... 


space_privilege is RESOURCE. Currently there is only one space 


privilege. 

tablespace is an existing tablespace to which the user has been 
granted RESOURCE privileges. 

user is an existing user who was previously granted 


RESOURCE privilege on tablespace. 


This form denies the user the ability to create objects in the tablespace. 
No future objects may be created and current objects will not be 
permitted to allocate further database space. 


To deny SCOTT the ability to create objects in the SYSTEM tablespace, 
enter: 


REVOKE RESOURCE ON SYSTEM FROM SCOTT 

The preceding statement is also equivalent to: 
GRANT RESOURCE(0) ON SYSTEM TO SCOTT 

AUDIT Form II and GRANT Form II statements. 
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REVOKE (Form IID 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Revoke access privileges from one or more users for tables, views, and 
sequences. 


You must own the database object or have been granted WITH GRANT 
OPTION on the table. 


REVOKE { object_priv [,object_priv]... | ALL [PRIVILEGES] } 
ON [user.]object 
FROM { user | PUBLIC } [,user]... 
object_priv For tables, is one of: ALTER, DELETE, INDEX, 
INSERT, REFERENCES, SELECT or UPDATE. 


For views, is one of: DELETE, INSERT, SELECT, or 
UPDATE. 


For sequences, is either ALTER or SELECT, 
ALL PRIVILEGES revokes all privileges. 


ON object specifies the name of the table, view, sequence, or 
synonym you are revoking privileges from. The 
object is an object you own or an object to which 
you have been granted WITH GRANT OPTION. 


user is the username of a user whose privileges are to be 
revoked. FROM PUBLIC revokes privileges 
originally granted to PUBLIC, but does not revoke 
individual grants on that same object. 


PUBLIC represents all users, present and future. 
This form revokes privileges on tables, views, sequences, or synonyms 
from one or more users. 


Tf user has been authorized to access an object by more than one 
person, that user may continue to access the object until privileges have 
been revoked by all who granted it. 


Revoking a privilege from a user also revokes it from others to whom 
that user has granted it. 
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REVOKE (Form II) 
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Examples 


Related Topics 


To revoke user JONES’s privileges to make changes to the table ‘ 
DEPT10, enter: 
REVOKE ALTER, DELETE, INSERT, UPDATE 

ON DEPT10 

FROM JONES 


To revoke all privileges on DEPT10 from all users who do not have 
explicitly granted privileges, enter: 
REVOKE ALL 


ON DEPT10 
FROM PUBLIC 


To revoke BLAKE’s privileges on the ESEQ sequence, ELLY would 
enter: 


REVOKE ALL 
ON ESEQ 
FROM BLAKE 


If ELLY has DBA privilege, then ELLY could revoke SELECT on 
BLAKE’s BSEQ sequence from SCOTT with the following command: 


REVOKE SELECT 
ON BLAKE.BSEQ 
FROM SCOTT 


AUDIT and GRANT statements. 
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ROLLBACK 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Undo work done in the current transaction. 
None. 


ROLLBACK [ WORK ] 
{[ TO [ SAVEPOINT ] savepoint ] 


WORK is optional and is provided for ANSI compatibility. 

SAVEPOINT is optional and is used to rollback a partial 
transaction, as far back as the specified savepoint. 

savepoint is a savepoint created during the current 
transaction. 


A transaction (or a logical unit of work) is a sequence of SQL statements 
that ORACLE treats as a single unit. A transaction begins with the first 
executable SQL statement after a COMMIT, ROLLBACK or connection 
to the database. A transaction ends with a COMMIT statement, a 
ROLLBACK statement, or disconnection (intentional or unintentional) 
from the database. Note that ORACLE issues an implicit COMMIT 
before and after any DDL SQL statement. For a complete description of 
transactions and transaction processing, refer to Chapter 11 
"Transaction Control” of the ORACLE RDBMS Database Administrator's 
Guide . 


Using ROLLBACK without a SAVEPOINT clause: 


* ends the transaction 

+ undoes all changes in the current transaction 

* erases all savepoints in that transaction 

* releases the transaction’s locks, 

Using the ROLLBACK with the TO SAVEPOINT clause: 

* rolls back just a portion of the transaction (back to the named 
savepoint) 

* retains the savepoint rolled back to, but loses all savepoints 
created after the named savepoint. Thus, you may rollback to 
the same savepoint multiple times. Prior savepoints are not 
affected. 

* releases all table and row locks that were acquired since the 
savepoint was taken. 
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ROLLBACK 
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Example 


Related Topics 


Recommended practice is-to explicitly end transactions in application 
programs using either the COMMIT WORK or ROLLBACK WORK 
statement. If you do not explicitly commit the transaction and the 
program terminates abnormally, the last uncommitted transaction 
will be rolled back. 


To rollback the entire transaction, enter: 
ROLLBACK 

To rollback to savepoint SP5, enter: 
ROLLBACK TO SAVEPOINT sP5 


COMMIT, SET TRANSACTION and SAVEPOINT statements; Chapter 
11 "Transaction Control" of the ORACLE RDBMS Database 
Administrator's Guide. 
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ROLLBACK (Embedded SQL) 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Related Topics 


End the current transaction and discard all changes in the current 
transaction and release ail locks. The RELEASE option is used to both 
release resources and disconnect from the database. 


None. 


EXEC SQL [AT dbname} ROLLBACK [WORK] 
[TO [SAVEPOINT] savepoint] 


[RELEASE] 

AT dbname is an optional clause indicating the name of the 
database where the ROLLBACK should be issued. 

WORK is optional and has no effect on ROLLBACK. 

SAVEPOINT is optional and is used to rollback a partial 
transaction, as far back as the specified savepoint. 

savepoint is the option used to rollback to a previously 
declared savepoint. 

RELEASE is an optional parameter that releases all resources 


and disconnects you from the database. 


You should always explicitly commit or rollback the last transaction in 
a program using the RELEASE option. If RELEASE is not specified, 
then locks obtained during the program may be held after program 
termination until the ORACLE recognizes that the process is no longer 
active. This may cause other users to wait for, or fail to obtain, the 
locked resources. 


ORACLE automatically rolls back changes if the program terminates 
abnormally. 


The ROLLBACK WORK statement has no effect on the contents of the 
host variables or on the control flow of the program. 


COMMIT, SAVEPOINT, and SET TRANSACTION statements. 
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SAVEPOINT 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Identify a point in a transaction to which you can later rollback with 
the ROLLBACK TO SAVEPOINT statement. 


None. 


SAVEPOINT savepoint 
or in embedded SOL: 
EXEC SQL SAVEPOINT savepoint 


savepoint is the name of the savepoint you wish to create. 
The name of the savepoint is a SQL identifier and 
must follow the standard conventions for naming 
identifiers, but need not be distinct among a given 
user’s database objects. 


Savepoints are used in conjunction with the ROLLBACK statement to 
rollback portions of the current transaction. 


By default, the maximum number of active savepoints per transaction 
is 5. An active savepoint is one which has been specified since the last 
commit or rollback. This limit can be changed by changing the value 
for the INIT.ORA parameter SAVEPOINTS. The absolute limit is 255 
active savepoints. 


Savepoints are useful in interactive programs, because you can create 
and name intermediate steps of a procedure. This allows you more 
control over longer, more complex procedures. For example, you can 
use savepoints throughout a long complex series of updates, so that if 
you make an error, you need not resubmit every statement. 


Savepoints are useful in application programs in a similar way. Ifa 
procedure contains several functions, a savepoint can be created before 
each function begins. Thus, if a function fails, it is easy to return the 
data to its state before the function began and then re-execute the 
function with revised parameters or perform a recovery action. 


Savepoint names must be distinct within a given transaction. If you 
create a second savepoint with the same identifier as an earlier 
savepoint, the earlier savepoint is erased. After a savepoint has been 
created, you can either continue processing, commit your work, 
rollback the entire transaction, or rollback to the savepoint. 
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Transaction 


Examples 


Related Topics 


SAVEPOINT 


A transaction (or a logical unit of work) is a sequence of SQL statements 
that ORACLE treats as a single unit. A transaction begins with the first 
executable SQL statement after a COMMIT, ROLLBACK or connection 
to the database. A transaction ends with a COMMIT statement, a 
ROLLBACK statement, or disconnection (intentional or unintentional) 
from the database. Note that ORACLE issues an implicit COMMIT 
before and after any DDL SQL statement. For a complete description of 
transactions and transaction processing, refer to Chapter 11 
"Transaction Control" of the ORACLE RDBMS Database Administrator's 
Guide. 


To update BLAKE’s and CLARK’s salary, check that the total company 
salary doesn’t exceed 20,000, then reenter CLARK’s salary, enter: 


UPDATE EMP 
SET SAL = 2000 
WHERE ENAME = ‘BLAKE’ 


SAVEPOINT BLAKE_SAL 


UPDATE EMP 
SET SAL = 1500 
WHERE ENAME = ‘CLARK! 


SAVEPOINT CLARK_SAL 
SELECT SUM(SAL) FROM EMP; 
ROLLBACK TO SAVEPOINT BLAKE _SAL 


UPDATE EMP 
SET SAL = 1300 
WHERE ENAME = ‘CLARK’ 


COMMIT 


COMMIT, ROLLBACK, and SET TRANSACTION statements. 
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SELECT 


Purpose Display rows and columns from one or more tables. May be used as a 
statement, or (with certain restrictions on clauses) as a query or 
subquery in another statement. 


Prerequisites Must own the table, or have SELECT privilege on the table(s), or have 
DBA privilege. 


Syntax SELECT {ALL| DISTINCT} { * | table.* | expr [c_alias]} 
{, {table.*) expr [c_alias] } ]..- 
FROM [user.]table [t_alias) {, [user.]table [t_alias]]... 
[ WHERE condition } 
[ CONNECT BY condition [START WITH condition) ] 
{ GROUP BY expr[, expr]... [HAVING condition] ] 
{ {UNION|INTERSECT|MINUS} SELECT ... ] 
{ ORDER BY {expr|position} [ASC| DESC] 
[, {expriposition} fASC|DESC]] ]... 
[ FOR UPDATE OF column [, column]... (NOWAIT] } 


Keywordsand ALL is the default and specifies that all rows that satisfy 
Parameters the SELECT statement should be displayed. 


DISTINCT specifies that duplicate rows should be removed 
before the rows are returned. A row is considered 
a duplicate of another if every value for each 
column of the SELECT clause matches that of 


another row(s). 

= specifies that all columns from all tables listed in 
the FROM clause be displayed. 

table.* specifies that all columns from the named table be 
displayed. 

expr (Refer to the syntax description of expr in Chapter 


4 "Operators and Functions" of this Manual.) 


c_alias provides a different name for the column 
expression and causes the alias to be used in the 
column heading. Does not affect the actual name 
of the column. Column aliases cannot be 
referenced elsewhere ina query. 


[user.]table specifies which table(s) or view(s) to display, 
optionally prefaced by the owner name of the 
table. If not specified, the owner name defaults to 
the current user. 
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Usage Notes 


SELECT 


t alias provides a different name for the table for the 
purpose of evaluating the query and is most often 
used in a correlated query. Other references to the 
table throughout the query must refer to the alias 
name. 


condition (Refer to the syntax description of condition in 
Chapter 4 "Operators and Functions" of this 
Manual.) 


position identifies a column based on its relative position in 
the SELECT column list rather than by its name. 


ASC | DESC specifies the column should be sorted ascending or 
descending based on the operating system 
collating sequence. 


column is a column belonging to a table listed in the FROM 
clause. 


NOWAIT specifies that ORACLE should return control to the 
user, rather than waiting, if it attempts to lock a 
row that is locked by another user. 


Many of the SELECT clauses are individually described in Chapter 6 
"SELECT Statement Clauses” of this Manual. 


Clauses must be used in the order shown above, except that: 


+ CONNECT BY, START WITH, GROUP BY, and HAVING may 
be specified in any order. 


* ORDER BY and FOR UPDATE OF may be interchanged. 


Although it is usually optional to preface the column name with the 
table name and the table name with the username, it is always better to 
explicitly qualify table and column references. ORACLE often does less 
work with fully qualified table and column names, Qualified column 
names are required if two or more tables have some column names in 
common. 


Each expr becomes the name of one column in the display, and each 
table* becomes a set of columns, one for each column in fable in the 
order they were defined when the table was created. The width and 
datatype of each expression is determined by the elements of the 
expression. 


The asterisk character, *, represents all columns ina table. If multiple 
tables are specified in the FROM clause, then * represents all columns 
from all tables, The asterisk may be prefaced by table., which limits the 
columns to those belonging to the named table. 
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SELECT 


CONNECT BY 


START WITH 


Each alias, if specified, is used to label the preceding expr in the table so 
that the column is displayed with a new heading: An alias has no effect 
on the actual name of the column, and cannot be referenced in the 
remainder of the query. 


FROM fable specifies the table or view to be selected from. More than 
one fable implies a join. A table alias value, if specified, must be used as 
an alias for the fable throughout the entire SELECT statement. 


WHERE specifies a condition to be used to select rows and /or join 
tables. This condition may often contain subqueries a nested SELECT 
statement. 


CONNECT BY is used for querying hierarchical relationships. 
CONNECT BY specifies that rows are to be retrieved in a hierarchical 
order, and defines the relationship to be used to connect table rows into 
a hierarchy. The PRIOR clause must be used before one side of the 
condition. The PRIOR side represents the parent in each parent-child 
relationship between nodes; the other side represents the child. For 
example, CONNECT BY PRIOR EMPNO = MGR means that the 
EMPNO field in a parent node equals the MGR field in each of its child 
node. The number of CONNECT BY levels is limited by available user 
memory. 


You may not use CONNECT BY in conjunction with: 


* subqueries 

* joins 
START WITH identifies the row(s) to be used as the root(s) of the tree 
by specifying a condition that they must satisfy. The omission of 
START WITH is identical to starting with all rows that satisfy the 
WHERE clause of the SELECT statement. 


Subqueries are permitted in a START WITH clause. 


When a SELECT statement contains the CONNECT BY clause, it may 
use the pseudo-column LEVEL. LEVEL returns a number value of 1 for 
a root node, 2 for a child node of a root node, 3 for a grandchild, etc. 


Refer also to the LEVEL pseudo-column in Chapter 3 "Elements of the 
SQL Language" and the START WITH clause in Chapter 6 "SELECT 
Statement Clauses" of this Manual. 
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GROUP BY, HAVING 


Set Operators 


ORDER BY 


FOR UPDATE OF 


SELECT 


The GROUP BY and HAVING clauses are used to display summary 
information about groups of rows that have the same values in one or 
more fields. Refer to the GROUP BY clause in Chapter 6 "SELECT 
Statement Clauses" of this Manual. 


The UNION, INTERSECT, and MINUS operators combine the results 
of two SELECT statements into a single result. UNION returns those 
results returned by either component query and eliminates duplicate 
results; INTERSECT returns only those rows returned by both queries; 
and MINUS returns those rows returned by the first SELECT after 
removing those rows that also are returned by the second SELECT. The 
number and types of the columns selected by each component query 
must be the same (but the lengths need not be the same). 


If more than two SELECTs are combined in this way, adjacent pairs of 
SELECTs are evaluated from the top down. (Parentheses may be used 
to specify evaluation in a different order.) All three operators imply 
DISTINCT in all SELECTs. 


The ORDER BY clause specifies the order in which rows of the table are 
returned. Refer to the ORDER BY clause in Chapter 6 "SELECT 
Statement Clauses" of this Manual. 


The FOR UPDATE clause locks the selected rows of the tables. The 
SELECT ... FOR UPDATE statement is normally followed by one or 
more UPDATE...WHERE statements. Once you have locked a row, 
other users cannot lock or update it until you free it with a COMMIT or 
ROLLBACK statement. (Other users only see changes after you have 
commit them.) 


FOR UPDATE signals that you intend to update the rows returned by 
the SELECT, but does not require you to update the rows. The term 
"update" includes the UPDATE, INSERT and DELETE statements. 


SELECT ... FOR UPDATE cannot be used with: 


» DISTINCT or GROUP BY 
+ UNION, INTERSECT, or MINUS operators 
* set functions like COUNT and MAX. 


NOWAIT makes SELECT terminate, rather than wait, if a row selected 
by FOR UPDATE OF cannot be locked because someone else is using it. 
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SELECT 


Sequences 


Subquery 


Examples 


Related Topics 


AGELECT statement may also refer to the sequence pseudo-columns 
NEXTVAL and CURRVAL. Fora complete definition of sequences and 
their use, refer to the CREATE SEQUENCE statement earlier in this 
chapter. 


Refer to the syntax description of query in Chapter 6 "SELECT 
Statement Clauses" of this Manual. 


To display ENAME, SAL, JOB, and DEPTNO from all rows of the table 
EMP in which the department number is 30 or less, enter: 
SELECT ENAME, SAL, JOB, DEPTNO 

FROM EMP 

WHERE DEPTNO=30 
The FROM, WHERE, GROUP BY, HAVING, ORDER BY clauses; the 
syntax descriptions of simple join, outer join, and query in Chapter 6, 
"SELECT Statement Clauses” of this Manual. 
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Dc) 
SELECT (Embedded SQL) 


Purpose Retrieve rows from the specified table. The values returned are 
assigned to the output host variables. 


Prerequisites Must own the table, or have SELECT privilege for the table, or have 
DBA privilege. 


Syntax EXEC SQL (AT dbname] [FOR thost_integer] 
SELECT select_list 


INTO :host_variable (,thost_variable]... 
FROM table list 
{ WHERE condition ] 
CONNECT BY condition [START WITH condition] ] 
GROUP BY expr[, expr]... [HAVING condition] ] 
{UNION| INTERSECT|MINUS) SELECT ... ] 
ORDER BY (expr|position} {ASC | DESC] 
(, {expr{position} [ASC|DESC]] ]... 
{ FOR UPDATE OF column [, column]... [NOWAIT] ] 


Keywords and AT dbname is an optional clause that refers to a previous 


Parameters 


CONNECT statement. This database name must 
have been previously declared ina DECLARE 
DATABASE statement. 


FOR :host_integer limits the maximum number of rows fetched. 


Refer to the FOR clause in Chapter 6 "SELECT 
Statement Clauses" of this Manual. 


select_list identical to the normal SELECT statement except 


that a host variable may be used wherever a 
constant may be specified. 


INTO introduces the list of output host variables. The 


host variable is declared as a normal procedural 
language variable and is either predefined or 
user-defined for use in a SQL statement. If any 
host variable in the INTO list is an array, all host 
variables must be arrays, but they are not required 
to be arrays of the same size. 


FROM identical to the non-embedded SELECT statement. 
Note: you may not use host variables for table 
names. 

WHERE may contain references to host_variables, but may 
not reference arrays. 

condition is a logical expression containing references to host 


variables or host arrays. Refer to the syntax 
description of condition in Chapter 4 "Operators 
and Functions” of this Manual. 
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Usage Notes 


Examples 


Related Topics 


All other keywords and parameters are identical to the non-embedded 
SQL SELECT statement. 


The embedded SELECT statement is most often used to return one row 
at a time, but when using arrays as host variable targets, may retrieve 
multiple rows per FETCH. 


If no row is returned, the SELECT statement assigns the value +100 
(+1403 in Version 5 compatibility mode) to sqicode and does not assign 
values to the host variables. The WHENEVER statement can be used to 
specify the conditional flow of control when the NOT FOUND (+100) 
condition (no rows returned) occurs. 


The SELECT statement can be used in a DECLARE CURSOR or 
PREPARE statement in conjunction with a later FETCH statement. In 
these cases, it may include a FOR UPDATE OF clause: 
EXEC SQL DECLARE cl CURSOR 
FOR SELECT column [,column, ...] 
FROM tableiview [, table|view] [, ...] 


WHERE search condition 
FOR UPDATE OF column [, column] [, ...] 


The column names specified can then be referenced in a CURRENT OF 
clause of a UPDATE statement which would follow the FETCH 
statement. For details, refer to the DECLARE CURSOR statement 
earlier in this chapter 


The following example illustrates the use of embedded SELECT: 


EXEC SQL SELECT ENAME, SAL + 100, JOB 
INTO :ENAME, :SAL, :JOB 
FROM EMP 
WHERE EMPNO = :EMPNO; 


The following example illustrates the use of a SELECT statement: 


EXEC SQL INSERT INTO EMP (ENAME, DEPTNO) 
SELECT * FROM NEWHIRES 


PREPARE, DECLARE CURSOR, FETCH, and EXECUTE statements. 
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SET TRANSACTION 
Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Establish the current transaction as READ ONLY. 


None. 


SET TRANSACTION {READ ONLY} 
READ ONLY is a required parameter. 


The default state for all transactions is statement level read consistency. 
Transaction level read consistency can be explicitly set with the SET 
TRANSACTION READ ONLY statement. After a transaction has been 
set to READ ONLY, all subsequent queries in that transaction will only 
see changes committed before the transaction began. This functionality 
is very useful for reports that run multiple queries against one or more 
tables while other users update these same tables. 


The SET TRANSACTION statement must be the first SQL statement in 
the transaction; if not, an error will be returned. SET TRANSACTION 
may be issued only once in a transaction. The use of READ ONLY does 
not affect other users or transactions. For a complete definition of 
transactions and transaction processing, refer to Chapter 11 
"Transaction Control" of the ORACLE RDBMS Database Administrator's 
Guide. 


Only queries are permitted in a READ ONLY transaction; INSERT, 
UPDATE and DELETE are not permitted. 


The read consistent state of the transaction will exist until the 
transaction ends that is, until a COMMIT or a ROLLBACK. Because 
ORACLE issues an implicit COMMIT before and after each Data 
Definition Language (DDL) statement and thus terminates a 
transaction, a DDL statement also terminates a READ ONLY 
transaction. As with all DDL statements, no indication is given that the 
transaction has been terminated implicitly (users are notified of explicit 
terminations) and a new transaction has started. You should explicitly 
terminate all transactions rather than relying on the implicit 
termination of a DDL statement. 


The read consistency that READ ONLY provides is implemented in 
that same way statement level read consistency is implemented. Every 
statement by default sees a consistent view of the data as of the time the 
statement began. READ ONLY transactions present a consistent view 
of the data as of the time of the SET TRANSACTION statement. 
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SET TRANSACTION 


As changes are made to table data, a record of these changes is stored 
in the database's rollback segments. When a statement encounters a 
block that changed after the start of the statement, ORACLE 
reconstructs the data as it existed before the changes were made. 
Before initiating long running READ ONLY transactions that access 
frequently updated tables, it may be necessary to create more rollback 
segments to support the READ ONLY transaction. The DBA can do 
this. 


Example The following statements could be run at midnight of the last day of 
every month to count how many ships and containers the company 
owns. This report would not be affected by any other user who might 
be in the process of adding or removing ships and/or containers. 
COMMIT 
SET TRANSACTION READ ONLY 
SELECT COUNT(*) FROM SHIP 
SELECT COUNT (*) FROM CONTAINER 
COMMIT 
Note that the last COMMIT statement does not actually make 
permanent any changes to the database; rather, it is used to end the 
READ ONLY transaction. 


Related Topics COMMIT, ROLLBACK, and SAVEPOINT statements; Chapter 11 


"Transaction Control" of the ORACLE RDBMS Database Administrator's 
Guide. 
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Storage clause 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Specify characteristics of database storage for various database objects 
including tables, indexes, and clusters. Several SQL statements contain 
a phrase to define storage, usually prefixed with the keyword 
STORAGE or DEFAULT STORAGE. These statements include: 


CREATE TABLESPACE 
CREATE TABLE 

CREATE CLUSTER 

CREATE INDEX 

CREATE ROLLBACK SEGMENT 


as well as the statements to ALTER these objects. 
none 


STORAGE( [ INITIAL integer ] { NEXT integer ] 
[ MINEXTENTS integer ] { MAXEXTENTS integer ] 
{ PCTINCREASE integer ] ) 


integer (Refer to the syntax description of integer in 
Chapter 3 "Elements of the SOL Language" of this 
Manual.) 


INITIAL The size in bytes of the first extent allocated when 
the object is created — the original amount of 
space allocated to the object. The default initial 
extent size is 10240 bytes. The minimum INITIAL 
is 4096 bytes, the maximum is 4095 megabytes. All 
values are rounded to the nearest ORACLE block 
size. 


NEXT The size in bytes of every subsequent extent to be 
allocated. Default is 10240 bytes. The minimum 
NEXT is 2048, the maximum is 4095 megabytes. 
All values are rounded to the nearest ORACLE 
block size. 


This size is a base value, which may remain 
constant for each new extent, or may change, 
depending on the value for PCTINCREASE. 


If PCTINCREASE is zero (0) then every subsequent 
extent is the same size, the size specified by NEXT. 


If PCTINCREASE is positive (as in 10) then every 
subsequent extent will grow that percent (10%) 
over the previous extent allocated. 
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Usage Notes 


Example 


Related Topics 


MAXEXTENTS The total number of extents, including the first, 
which can ever be allocated. Default is 99 extents. 


MINEXTENTS The total number of extents to be allocated when 
the segment is created. This allows for a large 
allocation of space when an object is created, even 
if the space available is not contiguous. Default is 1 
extent, meaning that just the initial extent is 
allocated. 


If MINEXTENTS is greater than 1, then the 
specified number of subsequent extents are 
allocated at CREATE time using the values 
INITIAL, NEXT, and PCTINCREASE. 


PCTINCREASE The percent by which each NEXT extent will grow 
over the last extent allocated. If PCTINCREASE 
is zero, then the size of each additional extent 
remains constant. The default PCTINCREASE is 
50. The default of 50 allows the size of each extent 
to grow as the table grows. This requires fewer 
extents for a given table size, thereby reducing I/O. 


Each time NEXT is calculated, it will grow by 
PCTINCREASE. The result of PCTINCREASE 
multiplied by the size of the last extent is 
rounded up to the next multiple of a block size. 
PCTINCREASE cannot be negative. 


The preceding storage parameters may affect both the time it takes to 
access data stored within the database as well as how efficiently space 
is used within the database. For a complete discussion of the 
ramifications of these parameters, refer to Chapter 4 "Tuning I/O" of 
the ORACLE RDBMS Performance Tuning Guide. 


The storage parameters you specify in ALTER statements, such as 
ALTER TABLE, only affect future extent allocations. Therefore, you 
cannot change the values of INITIAL or MINEXTENTS. 


STORAGE ( INITIAL 100K NEXT 50K 
MINEXTENTS 1 MAXEXTENTS 50 
PCTINCREASE 5 ) 


CREATE TABLE, CREATE INDEX, CREATE CLUSTER, and CREATE 
ROLLBACK SEGMENT statements. 
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Refer to the Constraint clause earlier in this chapter. 


TS 
UPDATE 
Purpose Change the data in the specified table. 
Prerequisites You must own the table, or have UPDATE privilege on the table, or 
have the DBA privilege. 
Syntax UPDATE [user.]table [alias) 
SET column = expr [,column = expr]... 
(WHERE condition] 
or 
UPDATE [user.]table [alias] 
SET (column [,column] ...} = (query) 
[, {column [,column] ...) = (query) ] ... 
(WHERE condition] 
Keywords and user is name of the owner of the table. 
Parameters sable is the name of an existing table that you can access. 
alias is used to relabel the name of the reference in the 
other clauses of the statement. 
column isa column within the table. No parentheses are 
required if the column list contains only one 
column, 
expr (Refer to the syntax description of expr in Chapter 4 
"Operators and Functions" of this Manual.) 
query is a SELECT statement without the ORDER BY or 
FOR UPDATE clause, often correlated with the 
table being updated. 
condition is a valid condition that evaluates to TRUE or 


FALSE. Refer to the syntax description for 
condition in Chapter 4 "Operators and Functions" of 
this Manual. 
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Usage Notes 


Query 


Correlated Update 


Examples 


The SET clause determines which columns are updated and what new 
values are stored in them. 


The WHERE clause determines the rows in which values are updated. 
If no WHERE clause is specified, all rows are updated. For each row 
that satisfies the WHERE clause, the columns to the left of the equals 
(=) operator in the SET clause are set to the values of the corresponding 
expressions on the right. The expressions are evaluated as the row is 
being updated. 


If the SET clause contains a subquery, it must return exactly one row 
for each row being updated. Each value in the query result is assigned 
respectively to the columns in the parenthesized list. If the query 
returns no rows, then the value (e.g SET value = query) will be set to 
NULL. Subqueries may select from the table being updated. 


The SET clause may intermix assignments of expressions and 
subqueries. 


The UPDATE statement automatically obtains exclusive locks on the 
rows or table being updated. These locks are released after a COMMIT 
or ROLLBACK statement is issued. 


If a subquery refers to columns from the table being updated, ORACLE 
will evaluate the subquery once for each row, rather than once for the 
entire update. This type of updated is call a correlated update. The 
reference to columns from the table being updated is usually 
accomplished by means of a table alias. 


Potentially, each row evaluated by the UPDATE statement could be 
updated with a different value as determined by the correlated 
subquery. Normal UPDATE statements will update each row with the 
same value. 


To set null commissions for all employees for whom the JOB column 
contains TRAINEE, enter: 
UPDATE EMP 


SET COMM = NULL 
WHERE JOB = ‘TRAINEE’ 


To promote JONES to manager of Department 20 with a $1,000 raise, 
(and assuming that you know there is only one JONES) enter: 


UPDATE EMP 
SET JOB = ‘MANAGER’, SAL=SAL+1000, DEPTNO=20 
WHERE ENAME = ’ JONES’ 
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UPDATE 


The following UPDATE shows: 
« how the two forms of SET may be mixed ina single statement 


+ the use of a correlated query 
« the use of a WHERE clause to limit which rows are updated. 


UPDATE EMP A 
SET DEPTNO = 
(SELECT DEPTNO 
FROM DEPT 
WHERE LOC = ‘BOSTON’), 
(SAL, COMM) = 
(SELECT 1.1*AVG(SAL), 1.5*AVG (COMM) 
FROM EMP B 
WHERE A.DEPTNO = B.DEPTNO) 
WHERE DEPTNO IN 
(SELECT DEPTNO 


FROM DEPT 
WHERE LOC = ‘DALLAS’ 
OR LOC = "DETROIT! ) 
The preceding update: 
* updates only those employees who work in Dallas or Detroit 
(WHERE clause) 
* sets DEPTNO for these employees to the DEPTNO of Boston 
(subquery) 


* sets each employee’s salary and commission to 1.5 times the 
average salary of their current department (correlated 
subquery). 


Related Topics DELETE and INSERT statements; WHERE clause. 
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UPDATE (Embedded SQL) 
Purpose Change the data in the specified table. 
Prerequisites Must own the table, or have UPDATE privilege for the table, or have 
DBA privilege. 
Syntax EXEC SQL [AT dbname] [FOR thost_integer] 
UPDATE {user.]table 
SET column [,column]... = ( { value [,value]... | query } ) 
{ WHERE { condition | CURRENT OF cursor_name } ] 
or 
EXEC SQL [AT dbname] [FOR shost_integer] 
UPDATE [user.]table 
SET columnl = { (value) | query } 
(, SET column2 = { (value) | query } ]..-- 
{ WHERE {search_condition|CURRENT OF cursor_name}] 
Keywordsand AT dbname specifies the name of a non-default database. 
Parameters 


FOR :host_integer _ limits the maximum number of array components 
processed by the UPDATE operation. 


table names the table to be updated. 


column lists the name of one or more column for which 
values are provided. Each specified columns must 
belong to a table specified in the INTO clause, 


value is defined as :host_variable[:indicator], literal, or 
expression. 

query is a form of the SELECT statement without an 
INTO clause. 

WHERE clause is a particular search condition for the rows that 


are to be updated. If the WHERE clause is 
omitted, all rows of the table or view are updated. 


condition is a logical expression containing references to host 
variables or host arrays. The search condition may 
contain a query. Refer to the syntax description of 
condition in Chapter 4 "Operators and Functions” of 
this Manual. 
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Usage Notes 


UPDATE (Embedded SQL) 


CURRENT OF refers to the row last processed by the FETCH 
statement associated with the named cursor. The 
following restrictions apply: 


° The cursor must be declared using the 
SELECT... FOR UPDATE clause if the 
CURRENT OF clause is to be used in 
conjunction with an UPDATE. Refer to the 
DECLARE CURSOR statement earlier in this 
chapter. 

* The cursor must be open and positioned ona 
row. 

« Ifno FETCH has been made or the cursor is not 
open, the CURRENT OF clause returns no rows. 


If the host variables are arrays, the UPDATE statement is executed once 
for each set of array components. Each execution of the UPDATE 
statement may update zero, one, or more rows. 


If any of the host variables used in the WHERE clause or SET clause is 
an array, then all of the host variables in both the WHERE clause and 
SET clause must be arrays. The arrays may be of different sizes, but the 
number of rows processed is determined by the size of the smallest 
array or the value specified in an optional FOR clause. 


If the WHERE clause is omitted, a warning flag will be raised in the 5th 
component of sqlwarn (SQLCA). 

If no rows satisfy the search_condition, no rows will be UPDATEd and 
the SQLCODE will return a NOT FOUND condition. 


The cumulative number of rows UPDATEd is returned in the SQLCA. 
When arrays are used as input host variables, this count reflects the 
total number of UPDATEs for all components of the array processed in 
the UPDATE statement. 
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UPDATE (Embedded SQL) 


Examples The following examples illustrate the use of the embedded UPDATE 
statement: 


EXEC SQL UPDATE EMP 
SET SAL = :sal, COMM = :comm 
WHERE ENAME = :ename; 


EXEC SQL UPDATE EMP 
SET SAL, COMM = {:sal, :comm) 
WHERE ENAME = :ename; 


EXEC SQL UPDATE EMP 
SET (SAL, COMM) = 
(SELECT SAL*1.1, COMM*1.1 
FROM EMP) 
WHERE ENAME = ‘JONES’; 


EXEC SQL UPDATE DEPT 
SET EMPCNT = 
{SELECT COUNT (*) 
FROM EMP 
WHERE EMP.DEPTNO = DEPT.DEPTNO); 


Related Topics PREPARE, and EXECUTE IMMEDIATE statements; FOR clause. 
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VALIDATE INDEX 
Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Example 


Related Topics 


Verify the integrity of the specified index. 
Must be the owner of the index or have DBA privilege. 


VALIDATE INDEX [user.]index 

user is the owner of the index. 

index is the name of the index to be validated. 

While this statement verifies that each index entry points to the correct 
data block, it does not confirm that each row has an appropriate index 
entry. ORACLE should reply that the index has been validated; if not, 
you should drop and recreate the index. 

To validate an index named ROSEBUD, enter: 

VALIDATE INDEX ROSEBUD 


CREATE INDEX statement. 
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WHENEVER (Embedded SQL) 
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Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Specify how error and warning conditions are handled. Generally, the 
WHENEVER statement should be the first executable statement in a 
program. This will insure that all error conditions are trapped. 


None. 


EXEC SQL WHENEVER {NOT FOUND | SQL ERROR | SQLWARNING} 
{CONTINUE | GOTO label_name | STOP} 


NOT FOUND identifies any exception condition that results in a 
return code of +100 in SQLCODE, (or +1403 in 
Version 5 compatibility mode). 


SQLERROR identifies a condition that results in a negative 
return code. 


SQLWARNING identifies a non-fatal warning condition. 


CONTINUE indicates that the program should progress to the 
next statement. 


GOTO label_name indicates that the program should branch to the 
statement named by label_name. 


STOP has no effect. 


The WHENEVER statement will embed an IF statement to check for the 
specified condition after each executable EXEC SQL statement. 


The scope of a WHENEVER statement is based solely upon its textual 
position in the code, and does not respect rules of language scoping. 
The LABEL specified in the WEIENEVER statement, however, must 
have the appropriate scope within the program. 


The WHENEVER statement remains in effect until it is overruled by 
another WHENEVER statement. 


The error-handling code called by the WHENEVER statement should 
specify WHENEVER SQLERROR CONTINUE to avoid infinite loops 
on errors. 


The WHENEVER embedded SQL statement is to be distinguished from 
the WHENEVER SQL?Plus command. 


The WHENEVER statement is used primarily to specify actions to be 
taken when: 


+ the last row of a query is FETCHed 
« aINSERT INTO... SELECT... inserts no rows. 
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Examples 


Related Topics 


WHENEVER (Embedded SQL) 


The example that follows illustrates the use of the WHENEVER 
statement: 


EXEC SQL WHENEVER SQLERROR GOTO some_problems; 


some, problems: 
EXEC SQL WHENEVER SQLERROR CONTINUE; 
EXEC SQL ROLLBACK RELEASE; 


FETCH and EXECUTE statements. 
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CHAPTER 


SELECT STATEMENT 
CLAUSES 


his chapter expands on the information on the SELECT statement 

presented in Chapter 5 "SQL Statement Syntax" of this Manual. 
Each clause of the SELECT statement is described in detail. Additional 
uses of the SELECT statement are also covered. 


Topics include: 


* FROM clause 

* WHERE clause 

¢ GROUP BY and HAVING clauses 
* ORDER BY clause 

+ CONNECT BY clause 

* simple joins 

* outer joins 

* query 

correlated queries 

distributed queries 
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FROM clause 
Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


Specifies a table or tables for a SELECT or DELETE statement. 
None. 


In DELETE statements: 

DELETE [FROM] [user.] table [@databaselink] [alias] 
[WHERE ...] 

In DELETE statements: 


SELECT select_list 
FROM fuser.] table [alias] [@databaselink] eee | 


WHERE 

user is the owner of the table or view. 

table is the name of the table or view. 

alias a temporary name assigned to a table or column an 
alias allows the same table to be referenced ina 
correlated query. The alias also allows you to 
abbreviate a table name within the query. 

databaselink is a valid database link that references a remote 


database. Refer to the CREATE DATABASE LINK 
statement in Chapter 5 "SQL Statement Reference" 
of this Manual. 


FROM is a required clause in the SELECT statement and is optional in 
the DELETE statement. It identifies the table from which rows are 
deleted, or the table(s) from which rows are selected. 


The REVOKE statement has a FROM clause which serves other 
functions. This description does not apply to that statement. 


If the table is owned by another user, the table name must be qualified 
with the owner’s username. The username and table name are 
separated by a period. 
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Examples 


Related Topics 


To delete rows with the value 50 in the DEPTNO column from a table 
named EMP, enter: 


DELETE FROM EMP 
WHERE DEPTNO = 50 


To select rows with the value 40 in the DEPTNO column from a table 
named EMP, enter: 


SELECT * FROM EMP 
WHERE DEPTNO = 40 


To select rows with the value 40 in the DEPTNO column from two 
tables named EMP and EMP2, enter: 


SELECT * 
FROM EMP, EMP2 
WHERE EMP.EMPNO = EMP2.EMPNO 
AND DEPTNO = 40 


If EMP2 is owned by another user whose user ID is BEN, enter: 


SELECT * 
FROM EMP, BEN.EMP2 
WHERE EMP.EMPNO = EMP2.EMPNO 
AND DEPTNO = 40 


SELECT and DELETE statements in Chapter 5 "SQL Statement 
Reference" of this Manual. 


ADEN 
GROUP BY and HAVING clauses 


Purpose 


Prerequisites 


Syntax 


Keywords and 
Parameters 


Operate on groups of rows that are returned in the query and limit 
(with the HAVING clause) which groups are affected. 


None. 


SELECT expr [{,expr]... 
PROM table [,table]... 
GROUP BY expr [,expr] ... 
HAVING condition 


expr (Refer to the syntax description of expr in Chapter 4 
“Operators and Functions" of this Manual.) 

table is a table or view to which you have access. 

condition (Refer to the syntax description of condition in 
Chapter 4 "Operators and Functions" of this 
Manual.) 
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Usage Notes Use the GROUP BY clause to make the SELECT statement retrieve one 
summary row for each group of selected rows. Each group of selected 
rows will be formed on the basis of having the same value for the 
column(s) or expression(s) of the GROUP BY clause. 


Each SELECT expr must either: 


* beaconstant or a function with no parameters (e.g. SYSDATE). 
* contain a grouping function such as SUM, COUNT, or MAX 
* exactly match an expr in the GROUP BY clause 

GROUP BY expressions can reference any column in the tables in the 


FROM clause, whether or not the columns are mentioned in the 
SELECT list. 


Specify GROUP BY and HAVING after WHERE and CONNECT BY ... 
START WITH. If both the GROUP BY and HAVING clauses are 
specified, they may be specified in either order. 


There is a system-dependent limit on the total number of bytes in all 
expressions in the GROUP BY clause. 


HAVING clause Use the HAVING clause to specify which GROUP BY groups are to be 
included in the result. ORACLE processes the WHERE, GROUP BY, 
. and HAVING clauses in the following manner: 


1. ORACLE removes all rows that do not satisfy the WHERE clause. 


2. ORACLE calculates and forms the groups as specified in the 
GROUP BY clause. 


3. ORACLE removes all groups that do not satisfy the HAVING 
clause. 


Examples To display the minimum and maximum salary for each department in | 
the table EMP, enter: 
SELECT DEPTNO, MIN(SAL), MAX (SAL) | 


FROM EMP 
GROUP BY DEPTNO 


DEP TNO MIN (SAL) MAX (SAL) 


10 1300 5000 
20 800 3000 
30 950 2850 
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Related Topics 


To apply this query only to clerks, enter: 


SELECT DEPTNO, MIN(SAL), MAX (SAL) 
FROM EMP 
WHERE JOB = ‘CLERK! 
GROUP BY DEPTNO 


DEPTNO MIN (SAL) MAX (SAL) 


ia 1300 1300 
20 800 1100 
30 950 950 


To make the query display only departments whose lowest salary is 
below $1,000: 


SELECT DEPTNO, MIN(SAL), MAX (SAL) 
FROM EMP 
WHERE JOB = ‘CLERK’ 
GROUP BY DEPTNO 
HAVING MIN(SAL) < $1000 


DEP TNO MIN (SAL) MAX (SAL) 


The section “Group Functions" in Chapter 4 “Operators and Functions"; 
SELECT statement in Chapter 5 "SQL Statement Reference" of this 
Manual. 


eA ALE 
WHERE clause 
Purpose Restrict which rows are returned from the table in a SELECT statement, 
or acted upon in a DELETE or UPDATE statement. 
Prerequisites None. 
Syntax DELETE ... 
WHERE condition 
SELECT ... 
WHERE condition 
UPDATE ... 
WHERE condition 
Keywords and condition (Refer to the syntax description for condition in 
Parameters Chapter 4 "Operators and Functions" of this 
Manual.) 
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Usage Notes 


Examples 


The purpose of a WHERE clause is to specify a condition. The 
statement containing the WHERE clause will act only on rows that 
satisfy the condition. 


The condition is defined by a logical expression. For example, 
DEP TNO=30 


is a logical expression that is true if the value of DEPTNO is 30, and 
otherwise is false. 


AND and OR may be used to form compound logical expressions. For 
example, the expression: 


DEPTNO=30 AND JOB=' SALESMAN’ 
is true only if both of the component expressions are true. 


NOT may be used to reverse the sense of an expression. For example, 
NOT ( DEPTNO=30 AND JOB='SALESMAN' } 

is true if: 

DEPTNO=30 AND JOB=' SALESMAN‘ 


is false. 


This statement selects all rows in which the value of DEPTNO is not 
equal to 30: 


SELECT * 
FROM EMP 
WHERE DEPTNO!=30 


This statement updates all rows in which the value of COMM is null: 


UPDATE EMP 
SET SAL = (1.1*SAL) 
WHERE COMM IS NULL 


This statement uses a correlated query to delete all departments that 
have no employees: 


DELETE FROM DEPT A 
WHERE NOT EXISTS 
(SELECT ‘TRUE’ 
FROM EMP B 
WHERE A.DEPTNO = B.DEPTNO) 
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For every row in the DEPT table, ORACLE performs the following 
steps: 


1. Determine the row’s DEPTNO. 


2. Use that row’s DEPTNO to determine if that DEPTNO exists in the 
EMP table. 


3. If the DEPTNO does not exist in the EMP table, delete the row. If the 
DEPTNO exists for any of the rows of the EMP table, do not delete 
the row. 


Note that this DELETE uses a correlated query because the query refers 
toa table in the parent query. The ‘TRUE’ constant is a place holder and 
can be replaced by any constant or column from the EMP table. The 
NOT EXISTS operator specifies that the row in question will be deleted 
if no rows are returned by the query. 


Related Topics The syntax description of query later in this chapter; the section 
"Operators" in Chapter 4 “Operators and Functions"; DELETE, SELECT, 
and UPDATE statements in Chapter 5 "SQL Statement Reference" of 
this Manual. 

RAS LEE 
WHERE clause (Embedded SQL) 
Purpose Restrict which rows are returned from the table in SELECT, DELETE, 
or UPDATE statements. 
Prerequisites None. 
Syntax The syntax for an embedded WHERE clause is as follows: 
SELECT ... 
FROM ... 
WHERE ( condition | CURRENT OF cursor name } 
Keywords and condition is a logical expression that may refer to host 
Parameters variables or host variable arrays (the WHERE 


clause of the SELECT may not contain host 
variable arrays). The search condition may contain 
aquery. Refer to the syntax description of query 


later in this chapter. 
CURRENT OF can only be used with DELETE or UPDATE; it 
cursor_name refers to the row last processed by the FETCH 


statement associated with the named cursor. 
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Usage Notes 


CURRENT OF Clause 
Example 
Related Topics 

6-8 


If a WHERE clause is omitted, all rows of the table or view are 
processed. Host variable references may be used in the statement 
anywhere constants are allowed. 


If the WHERE clause is omitted in a DELETE or UPDATE statement, 
the 5th component of sqlwarn (SQLCA) is set to ’W’ as a warning and 
the EXEC SQL WHENEVER SQLWARNING action is taken. 


If all host variables used in the WHERE clause search condition are 
arrays, the result is the same as if the statement had been executed once 
for each set of array components. 


If any of the host variables used in the WHERE clause are arrays, then 
all of the host variables in the WHERE clause must be arrays. 


The arrays may be of different sizes, in which case the smallest size (or 
the value specified in an optional FOR clause) is used to specify the 
number of times the SQL statement containing the WHERE clause is 
executed, 


The WHERE clause of the SELECT statement may not contain host 
variable arrays. 


If the CURRENT OF clause is used in an UPDATE statement, then the 
cursor must have been previously declared using the FOR UPDATE 
clause in the SELECT statement. The cursor must be open and 
positioned on a row. If no FETCH has been made or if the cursor is not 
open, the CURRENT OF clause results in an error and returns zero 
rows. 


To update the current row of the EMP table and set salary to 2000, enter: 


UPDATE EMP 

SET SAL = 2000 

WHERE CURRENT OF CURSOR EMP_CURSOR 
FOR clause and DECLARE CURSOR, FETCH, EXECUTE, and SELECT 
statements in Chapter 5 "SQL Statement Reference” of this Manual. 
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CONNECT BY and START WITH clauses 


Purpose 
Prerequisites 


Syntax 


Keywords and 
Parameters 


Usage Notes 


PRIOR 


Display data based on hierarchical relationships. 
None. 


SELECT ... 
FROM 


{ CONNECT BY {PRIOR expr operator expr 
| expr operator PRIOR expr} 
[ START WITH condition ] J 


PRIOR specifies direction of tree traversal. ORACLE will 
visit the PRIOR node before visiting the node 
without the PRIOR clause. 

expr (Refer to the syntax descriptions of expr and 
condition and the section "Operators" in Chapter 4 

operation “Operators and Functions" of this Manual.) 

START WITH 

condition 


The CONNECT BY clause is used for querying hierarchical relations. 
The CONNECT BY clause specifies that rows are to be retrieved ina 

hierarchical order, and defines the relationship to be used to connect 
table rows into a hierarchy. 


The PRIOR clause specifies the order of retrieval (parents first or 
children first). 


The PRIOR clause must be used before one of the expressions of the 
CONNECT BY clause. The PRIOR side represents the parent in each 
parent-child relationship; the other side represents the child. For 
example, CONNECT BY PRIOR EMPNO = MGR means that 
CONNECT by will return managers (identified by EMPNO) before 
employees (identified by MGR). CONNECT BY EMPNO = PRIOR 
MGR means that employees will be displayed before managers. 


The number of CONNECT BY levels is limited by available user 
memory. 


You may not use the CONNECT BY clause in conjunction with 
subqueries or joins. 
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START WITH 


Use of ORDER BY 


Example 


Related Topics 


START WITH identifies the row(s) to be used as the root(s) of the tree 
by specifying a condition that they must satisfy. The omission of 
START WITH is identical to starting with all rows that satisfy the 
WHERE clause of the SELECT statement. 


Subqueries are permitted in a START WITH clause. 


When a SELECT statement contains the CONNECT BY clause, it may 
use the pseudo-column LEVEL. LEVEL returns a number value of 1 for 
a root node, 2 for a child of a root, 3 for a grandchild, and so on. 


The use of ORDER BY destroys the order in which CONNECT BY 
returns rows. There is an implicit ORDER BY when you use 
CONNECT BY. If a row’s level is less than the previous row’s level, 
that row is considered a child of the previous row. ORDER BY, 
therefore, will mask the implicit order of rows returned by CONNECT 
BY. Although no error is returned, the use of ORDER BY negates the 
effect of CONNECT BY. 


SELECT LPAD(’ ',2*LEVEL) || ENAME ORG_CHART, EMPNO, MGR, JOB 
FROM EMP 


CONNECT BY PRIOR EMPNO = MGR 


START WITH ENAME = ‘KING’ 


ORG_CHART EMPNO MGR JOB 
KING 7839 PRESIDENT 
JONES 7566 7839 MANAGER 
scorr 7788 7566 ANALYST 
ADAMS 7876 7788 CLERK 
FORD 7902 7566 ANALYST 
SMITH 7369 7902 CLERK 
BLAKE 7698 7839 MANAGER 

ALLEN 7499 7698 SALESMAN 
WARD 7521 7698 SALESMAN 
MARTIN 7654 7698 SALESMAN 
TURNER 7844 7698 SALESMAN 
JAMES 7900 7698 CLERK 
CLARK 7782 7839 MANAGER 
MILLER 7934 7782 CLERK 


The syntax description of condition in Chapter 4 "Operators and 
Functions"; SELECT statement in Chapter 5 "SQL Statement Reference" 
of this Manual. 
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ORDER BY clause 
Purpose 


Prerequisites 
Syntax 


Keywords and 
Parameters 


Usage Notes 


Sort the result of a query. 

None. 

SELECT .. 

ORDER BY {expr|position} [ASC|DESC], ... 

expr is an expression based on one or more of the 
columns in the SELECT clause or from one of the 
tables in the FROM clause. 

position is a number identifying the position of a column in 


the SELECT clause. For example, rather than 
ordering by column names, position allows you to 
order by the first column in the select list. If the 
UNION, INTERSECT, or MINUS operator is used, 
ORDER BY items must be specified by position. 


ASC | DESC specifies ascending or descending order according 
to the collating sequence for the character set. Null 
values follow all others in ascending order and 
precede all others in descending order. Thus, nulls 
sort "high". 


Use the ORDER BY clause to specify the order in which the results of a 
query are to be displayed. The ORDER BY clause is the only method to 
guarantee the ordering of rows. 


Rows are ordered by the value of the first expr or position. Rows with 
the same value are ordered by the value of the second item (if one is 
specified), and so on. 


Sorting by position is useful when sorting by a long expression. Rather 
than retyping the entire expression in the ORDER BY clause, you can 
just supply the expression’s position in the SELECT clause. Sorting by 
position is necessary when using UNION, INTERSECT, or MINUS 
because the tables referenced by these operators need not have columns 
with the same name. 


You may not reference a column alias in the ORDER BY clause. 
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12 


Example 


Related Topic 


The ORDER BY clause is subject to the following restrictions: 


+ -The ORDER BY clause must be specified after all other clauses 
except the FOR UPDATE OF clause. The ORDER BY and FOR 
UPDATE OF clauses may be interchanged. 


+ If the ORDER BY clause and the DISTINCT operator are both 
specified, the ORDER BY clause may not refer to columns that 
are not mentioned in the SELECT clause. 


+ The ORDER BY clause is not permitted in subqueries in 
INSERT, UPDATE, CREATE TABLE, or CREATE VIEW 
statements. 


+ Avsystem-dependent limit applies to the total number of bytes 
in all expressions in the ORDER BY clause. 


The ORDER BY clause is applied after the CONNECT BY clause. It is 
recommended that you not use the ORDER BY clause in conjunction 
with the CONNECT BY clause as its use will negate the effect of the 
CONNECT BY clause. 


To select all salesmen’s records from EMP, and order the output by 
commission in descending order, enter: 
SELECT * 

FROM EMP 


WHERE JOB = ‘SALESMAN’ 
ORDER BY COMM DESC 


To select the employees from EMP ordered first by ascending 
department number and then by descending salary, enter: 


SELECT ENAME, DEPTNO, SAL 
FROM EMP 
ORDER BY DEPTNO ASC, SALARY DESC 


To select the same information as the previous SELECT and use the 
positional ORDER BY notation, enter: 


SELECT ENAME, DEPTNO, SAL 
FROM EMP 
ORDER BY 2 ASC, 3 DESC 


SELECT statement in Chapter 5 "SQL Statement Reference" of this 
Manual. 
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Simple Join 


Purpose 
Prerequisites 


Syntax 


Usage Notes 


Combine data from multiple tables. Result may be displayed or may bé 
used as input for another SQL statement. 


Must have SELECT access to or must be the creator of each table 
referenced. 


SELECT {{table}table_alias}.]column 
[, [{tablejtable alias}.]column]... 
FROM table [table_alias], table [table_alias]... 
(WHERE {table|table_alias}.column = (table|table_alias}.column] 


A join is the form of the SELECT statement that combines rows from 
two or more tables. Thus, each row of the result will have column data 
from more than one table. A join occurs whenever multiple tables are 
referenced in the FROM clause of the SELECT statement. The optional 
WHERE clause determines how the rows of the tables are combined. 
The following discussion assumes a join of two tables, but may be 
applied to joins of two or more tables. 


The most common type of join, the simple join, returns rows from two 
tables based on an equality condition. This condition appears in the 
WHERE clause in the form of: 


<tablel.columnname> = <table2.columnname> 


The rows of table1 are combined with the rows of table2 and the 
resulting rows are returned where the values of table1.columnname 
and table2.columnname are equal. 


The columns used in the WHERE condition need not have the same 
name. If the column names are identical, you must preface the columns 
with the table name so there is no ambiguity. 


If a table alias is used in place of the actual table name in the FROM 
clause, then that table alias must be substituted for the table name 
throughout the SELECT statement including references to the table in 
the SELECT list and WHERE clause. 


ORACLE places no restrictions on which columns from either table are 
actually displayed; none, some, or all columns from both tables may be 
returned. Thus, the columns specified in the WHERE clause need not 
appear in the SELECT clause. 


A simple join is also called an equi-join because it uses an = comparison 
operator in the WHERE clause. 
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Cartesian product 


Examples 


Related Topics 


A cartesian product is formed when tables are joined without the use of a 
WHERE clause. The omission of the WHERE clause causes all rows 
from all tables to be combined. A cartesian product always generates a 
large number of rows and its result is rarely useful. For example, if two 
tables each have one hundred rows, the resulting cartesian product will 
be ten thousand rows. 


You should always include a WHERE clause when joining tables unless 
you have a specific need to combine all rows of all tables. 


The following simple join answers the question, "What are the name 
and number of the department in which each employee works": 


SELECT ENAME, EMP.DEPTNO, DNAME 
FROM EMP, DEPT 
WHERE EMP.DEPTNO = DEPT.DEPTNO 


ENAME DEPTNO DNAME 


CLARK 10 ACCOUNTING 
MILLER 10 ACCOUNTING 
KING 10 ACCOUNTING 
SMITH 20 RESEARCH 
scortrT 20 RESEARCH 


A join is required because the data is stored in two different tables. 
Rows of the two tables are joined according to the WHERE condition: 


EMP.DEPTNO = DEPT.DEPINO. 


The syntax description of outer join later in this chapter; SELECT 
statement in Chapter 5 "SQL Statement Reference" of this Manual. 
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Purpose 


Prerequisites 


Syntax 


Join two or more tables together and also return those rows from one 
table which have no direct match in the other table. 


Must have SELECT privileges on or own each table referenced. 


SELECT ..- 
FROM tablel, table2... 
WHERE tablel.column = table2.column (+) 
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Usage Notes 


Example 


The outer join extends the result of a normal join. An outer join returns 
all the rows returned by the simple join and it also returns those rows 
from one table that do not match any row from the other table. For 
example, if we are selecting all employees from EMP and their locations 
from DEPT, there may be an employee whose dept is not listed in 
DEPT. We'd like to see his record along with the other employee’s. 


An outer join must contain a WHERE clause with a condition in one of 
these forms: 


tablel.column = table2,column (+) 


tablel.column (+) = table2.column 


Extra “null” columns will be "created" temporarily for the table with the 
(+) outer join operator and joined against all rows from the other table 
that would have not been returned in a normal join. 


The outer join symbol mast follow a column reference within a join 
condition. 


Within a single SELECT statement, a table may be outer joined to at 
most one other table. 


To display the total monthly salary for all departments (without an 
outer join), enter: 


SELECT DEPT.DEPTNO, DNAME, SUM(SAL) MONTHLY SALARY 
FROM EMP, DEPT 
WHERE EMP.DEPTNO = DEPT.DEPTNO 
GROUP BY DEPT.DEPTNO, DNAME 
ORDER BY DEPT.DEPTNO 


DEPTNO DNAME MONTHLY SALARY 
10 ACCOUNTING 8750 
20 RESEARCH 10875 
30 SALES 9400 
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Related Topics 


To display the total monthly salary for all departments, even those 
departments with no employees (with an outer join), enter: 


SELECT DEPT.DEPTNO, DNAME, SUM(SAL) MONTHLY SALARY 
FROM EMP, DEPT 
WHERE EMP.DEPTNO(+) = DEPT.DEPTNO 
GROUP BY DEPT.DEPTNO, DNAME 
ORDBR BY DEPT.DEPTNO 


DEPTNO DNAME MONTHLY SALARY 
10 ACCOUNTING 8750 
20 RESEARCH 10875 
30 SALES 9400 


40 OPERATIONS 

In the preceding outer join, the OPERATIONS department was 
displayed even though no employees in the EMP table belonged to the 
OPERATIONS department. 


The rule of thumb is to append the outer join symbol following the 
name of the table without the matching rows. 


The syntax description of simple join earlier in this chapter; SELECT 
statement in Chapter 5 "SQL Statement Reference” of this Manual. 


Query 
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Purpose 


Prerequisites 


Syntax 


A SELECT statement used within another SQL statement to obtain 
intermediate results. 


Dependent on the SQL statement used. 


SELECT (ALL|DISTINCT] { * | table.* | expr [c_alias]} 
[, {table.*|expr (c_alias] } ]... } 
FROM [user.] table [t_alias] [,{user.] table [t_alias]]... 
(WHERE condition] 
{CONNECT BY condition [START WITH condition] ] 
[GROUP BY expr[, expr]... [HAVING condition] ] 
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Usage Notes 


Queries may be used in the following SQL statements: 


CREATE ... AS query 

DELETE ... WHERE expr operator (query) -.- 
INSERT ... query 

SELECT ... WHERE expr operator (query) 


. HAVING expr operator (query) 
. START WITH expr operator (query) 


UPDATE ... 
SET (column, column, ... ) operator (query) 

. WHERE expr operator (query) ... 
All "normal" SELECT statements do not require either an ORDER BY or 
a FOR UPDATE OF clause. A SELECT statement is called a query when 
it appears within a condition of the WHERE clause of the SELECT 
statement or the set clause of the UPDATE statement. Subqueries are 
also known as nested queries or embedded queries. This Manual will use 
the term query. 


Queries are used in the following situations: 


* to define the set of rows to be inserted in the target table of an 
INSERT, CREATE TABLE, or COPY statement 


« to define one or more values to be assigned to existing rows in 
an UPDATE statement 

* to provide values for comparison in WHERE, HAVING, and 
START WITH clauses of SELECT, UPDATE, and DELETE 
statements 


There are no limits on the levels of nesting for a query. 


A query is used to answer multiple part questions. For example, to 
answer the question; "who works in TAYLOR’s department?", you 
must first answer the question; "what department does TAYLOR work 
in?" in a subquery. Then you can answer the original question with the 
parent query. The parent query is the portion of the SQL statement that 
contains the query. 


A query is evaluated once for the entire parent query, in contrast to a 
correlated query which is evaluated once per row in the parent query. 
Refer to the syntax description of correlated query later in this chapter. 
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Examples To determine who works in TAYLOR’s department, enter: 


SELECT ENAME, DEPTNO 
FROM DEPT 
WHERE DEPTNO = 
(SELECT DEPTNO 
FROM EMP 
WHERE ENAME = ‘ TAYLOR’) 


To give all employees in the EMP table a ten percent raise if they have 
not already been issued a bonus (ie. they do not exist in the BONUS 
table), enter: 


UPDATE EMP 
SET SAL = SAL ¥* 1.1 
WHERE EMPNO NOT IN (SELECT EMPNO FROM BONUS) 


To create a duplicate of the DEPT table named NEWDEPT, enter: 


CREATE TABLE NEWDEPT (DEPTNO, DNAME, LOC) 
AS SELECT DEPTNO, DNAME, LOC FROM DEPT 


Related Topics The syntax description of correlated query later in this chapter; 
SELECT statement in Chapter 5 "SQL Statement Reference" of this 
Manual. 


SE 
Correlated Query 


Purpose Evaluate a query for every row in the parent SQL statement. 
Prerequisites Dependent on the SQL statement used. 


Syntax SELECT column_list 
FROM tablel table_aliasl 
WHERE expr operator 
(SELECT column_list 
FROM table2 table_alias2 
WHERE table_aliasl.column operator table_alias2.column) 


UPDATE tablel table_aliasl 
SET column = 
(SELECT expr 
FROM table2 table_alias2 
WHERE table aliasl.column 


table_alias2.column) 


DELETE FROM tablei table_aliasl 
WHERE column operator 
(SELECT expr 
FROM table2 table_alias2 
WHERE table _aliasl.column = table_alias2.column) 
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Usage Notes 


Examples 


A correlated query is a form of a query used in a SELECT, UPDATE, or 
DELETE statement. This discussion will focus on the SELECT 
statement, although this discussion applies to all types of correlated 
subqueries. 


Use a correlated query to force ORACLE to evaluate the query once per 
row of the parent query rather than once for the entire query. 


A correlated query is used to answer multi-part questions whose 
answer depends on the value in each row of the parent query. For 
example, a correlated query can be used to answer the question; "which 
employees earn more than the average salary for their department?". 
The correlated query is used specifically to compute the average salary 
for each department. 


ORACLE understands that you wish to use a correlated query when 
you reference a column within the query that belongs to a table from 
the parent query. You specify that a column belongs to the parent 
query by prefacing it with a table alias associated with a parent query 
table. 


The columns within a correlated query should be prefixed by the table 
name or table alias for clarity. A reference to a column in the parent 
query must be prefixed by its table name or table alias if the tables in 
the query contain any co-umns with the same name, Unqualified 
columns in the query are looked up in the tables of the parent query, 
then in the tables of the next enclosing parent query, and so on. 


In the case of an UPDATE statement, a correlated query can be used to 
update rows in one table based on rows from another table. For 
example, if you have four quarterly sales tables that you would like to 
roll up into the yearly sales table, you would use a correlated query. 


In the case of a DELETE statement, you can use a correlated query to 
delete only those rows that also exist in another table. 


To display information about employees whose salary exceeds the 
average for their departments, you must use a correlated query. First, 
assign an alias to EMP, the table that contains the salary information, 
and then refer to that alias in the query: 
SELECT DEPTNO, ENAME, SAL 
FROM EMP X 
WHERE SAL > (SELECT AVG (SAL) 
FROM EMP 
WHERE X.DEPTNO = DEPTNO) 
ORDER BY DEPTNO 
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Related Topics 


For each row of EMP, the parent query uses the correlated query to 
compute the average salary for members of the same department. The 
correlated query performs the following steps for each row of the EMP 
table: 


1. The DEPTNO of the row is determined. 
2. The DEPTNO is then used to evaluate the query. 


3. If that row’s salary is greater than the average salary for that row’s 
department, then the row is returned. 


Thus, the query is evaluated once per row of the EMP table. 


Query examples for the CREATE TABLE and UPDATE statements 
appear with these individual statements in Chapter 5 "SQL Statement 
Reference" of this Manual. 


DELETE, SELECT, and UPDATE statements in Chapter 5 "SQL 
Statement Reference" of this Manual. 


Distributed Queries 


Identifying 
Remote Tables 


This section discusses distributed queries within ORACLE’s distributed 
database management system architecture. This architecture allows 
you to access data in remote databases using SQL*Net and an ORACLE 
RDBMS. For additional information, refer to Chapter 22 "Distributed 
Databases and Distributed Processing" of the ORACLE RDBMS 
Database Administrator's Guide and the SQL*Net User's Guide for your 
specific SQL*Net protocol. 


Table references may optionally contain a database link name, as 
described below: 


fuser.] table [@database_link] 


This example shows a query which joins a local table (DEPT) with the 
EMP table in the HOUSTON database: 
SELECT ENAME, DNAME 


FROM EMP@HOUSTON, DEPT 
WHERE EMP.DEPTNO = DEPT.DEPTNO 
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Restrictions on 
Distributed Queries 


Several restrictions currently apply to distributed processing with the 
ORACLE RDBMS. These are described below. 


Remote table references are only supported in the following areas: 


+ FROM clauses in SELECT, INSERT INTO ... SELECT, CREATE 
TABLE ... AS SELECT, and CREATE VIEW ... AS SELECT 
statements 

* FOR clauses in the CREATE SYNONYM statement 


« table qualifier of column references in the above statements. 
You may not select columns of type LONG from remote tables. 


Queries against a remote table using the CONNECT BY clause are 
subject to the following restrictions: 
+ the PRIOR keyword may only be used in conjunction with the 
CONNECT BY clause 
* the START WITH clause may not contain subqueries 
+ neither the START WITH clause nor the CONNECT BY clause 
may contain the USERENV(ENTRYID) function, user-defined 
functions, or the ROWNUM pseudo-column 
You may not INSERT into, UPDATE, or DELETE any data from remote 
tables. To do this you must log into the remote database directly using 
SQL*Net. 
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APPENDIX 


DATA DICTIONARY 


I [ ‘he Data Dictionary contains information about: 


* database objects 
¢ database users 
+ database events 


You can access this information through several views of the Data 
Dictionary. This Appendix describes these views. 
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Eee 
Data Dictionary Views 


This section describes the Data Dictionary views. The information in 
this section can also be found in the Data Dictionary view named 


DICTIONARY. 


Some Data Dictionary view names begin with the prefix "DBA". These 
views are accessible only to users with DBA privilege. All other views 


are available to all users. 


This table lists the Data Dictionary views: : 


View 


Description 





ACCESSIBLE_COLUMNS 
ACCESSIBLE_TABLES 
ALL_CATALOG 
ALL_COL_COMMENTS 


ALL_COL_GRANTS 
ALL_COL_GRANTS_ MADE 


ALL_COL_GRANTS_RECD 
ALL_CONSTRAINTS 
ALL_CONS_COLUMNS 
ALL_DB_LINKS 
ALL_DEF_AUDIT_OPTS 
ALL_INDEXES 
ALL_IND_COLUMNS 
ALL_OBJECTS 


ALL_SEQUENCES 
ALL_SYNONYMS 
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Columns of all tables, views and 
clusters accessible to the user 


Tables and views accessible to the 
user 


Tables, views, synonyms, 
sequences accessible to the user 


Comments on columns of tables 
and views accessible to the user 


Synonym for COLUMN_PRIVILEGES 
Grants on columns for which the 
user is the owner or the grantor 
Grants on columns for which the 
user or PUBLIC is the grantee 


Constraints on tables accessible to 
the user 


Primary, unique, and foreign key 
columns in constraints owned by the 
user or on tables accessible to the user 


Database links accessible to the user 


Default auditing options for 
newly created objects 


Indexes on tables and clusters 
accessible to the user 


Columns comprising indexes on 
tables and clusters accessible to 
the user 


Objects accessible to the user 
Sequences accessible to the user 
Synonyms accessible to the user 





View 


Description 





ALL_TABLES 
ALL_TAB_ COLUMNS 


ALL_TAB_COMMENTS 


ALL_TAB_GRANTS 
ALL_TAB_GRANTS_MADE 


ALL_TAB_GRANTS_RECD 


ALL_USERS 
ALL_VIEWS 
AUDIT_ACTIONS 


COLUMN_PRIVILEGES 


CONSTRAINT_COLUMNS 


CONSTRAINT_DEFS 
DBA_AUDIT_CONNECT 
DBA_AUDIT_DBA 


DBA_AUDIT_EXISTS 


DBA_AUDIT_RESOURCE 


DBA_AUDIT_TRAIL 
DBA_CATALOG 


DBA_CLUSTERS 
DBA_CLU_COLUMNS 


DBA_COL_COMMENTS 


Tables accessible to the user 
Synonym for 
ACCESSIBLE_COLUMNS 
Comments on tables and views 
accessible to the user 

Synonym for TABLE_PRIVILEGES 


Grants on objects for which the 
user is the owner or the grantor 


Grants on objects for which the 
user or PUBLIC is the grantee 


All database users 

Views accessible to the user 
Names and codes of audit trail 
action types 

Grants on columns for which the 
user is the grantor, grantee, or 
owner, or PUBLIC is the grantee 
Foreign key columns in 
constraints owned by the user or 
on tables accessible to the user 
Constraint on tables accessible to 
the user 

Synonym for 
USER_AUDIT_CONNECT 
Audit trail entries for actions 
requiring DBA privilege 

Audit trail entries for any action 
resulting in an error because a 
specified database object does not 
exist 

Synonym for 
USER_AUDIT_RESOURCE 
Synonym for USER_AUDIT_TRAIL 
All tables, views, synonyms, and 
sequences in the database 

All clusters in the database 


Mapping of table columns to all 
cluster columns 


Comments on columns of all 
tables and views in the database 
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View 


Description 





DBA_COL_GRANTS 


DBA_CONSTRAINTS 
DBA_CONS_COLUMNS 


DBA_CROSS_REFS 
DBA_DATA_ FILES 
DBA_DB_LINKS 


DBA_EXP_FILES 
DBA_EXP_OBJECTS 


DBA_EXP_VERSION 
DBA_EXTENTS 
DBA_FREE_SPACE 
DBA_INDEXES 


DBA_IND_COLUMNS 


DBA_OBJECTS 
DBA_ROLLBACK_SEGS 
DBA_SEGMENTS 


DBA_SEQUENCES 
DBA_SYNONYMS 
DBA_SYS_AUDIT_OPTS 
DBA_TABLES 
DBA_TABLESPACES 
DBA_TAB_AUDIT_OPTS 


DBA_TAB_COLUMNS 
DBA_TAB_COMMENTS 


DBA_TAB_GRANTS 
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All grants on columns in the 
database 


Constraints on all database tables 


All database columns used in 
constraints 


Cross references of all views, 
synonyms, and constraints in the 
database 

Database files 

All database links in the database 
Export files 


Objects that have been 
incrementally exported 


Version number of last export 
session 


Extents comprising all segments in 
the database 


Free extents in all tablespaces in 
the database 


All indexes in the database 


Columns comprising indexes on 
all tables and clusters in the 
database 


All objects in the database 
Rollback segments 


Storage allocated for all database 
segments 


All sequences in the database 
All synonyms in the database 
Current system auditing options 
All tables in the database 

All tablespaces 


Auditing options for all database 
tables and views 


Columns of all database tables, 
views, and clusters 


Comments on all database tables 
and views 


All grants on database objects 





View Description 

DBA_TS_ QUOTAS Tablespace quotas for all users 
DBA_USERS All database users 

DBA_VIEWS All views in the database 
DICTIONARY Data Dictionary tables and views 


DICT_COLUMNS 
DUAL 


TABLE_PRIVILEGES 


USER_AUDIT_CONNECT 
USER_AUDIT_RESOURCE 
USER_AUDIT_TRAIL 
USER_CATALOG 


USER_CLUSTERS 
USER_CLU_COLUMNS 


USER_COL_COMMENTS 


USER_COL_GRANTS 


USER_COL_GRANTS_MADE 
USER_COL_GRANTS_RECD 


USER_CONSTRAINTS 
USER_CONS_COLUMNS 


USER_CROSS_REFS 


USER_DB_LINKS 


Columns in Data Dictionary tables 
and views 

Dummy table containing one row 
and one columns. 


Grants on objects for which the 
user is the grantor, grantee, or 
owner, or PUBLIC is the grantee 


Audit trail entries for user logons 
and logoffs 


Audit trail entries for user actions 
that create or drop database objects 


Audit trail entries relevant to the 
user 


Tables, views, synonyms, and 
sequences owned by the user 


Clusters owned by the user 


Mapping of table columns to the 
user’s cluster columns 


Comments on columns of tables 
and views owned by the user 


Grants on columns for which the 
user is the owner, grantor or 
grantee 


Grants on columns of objects 
owned by the user 


Grants on columns for which the 
user is the grantee 


Constraints owned by the user 


Columns in constraints owned by 
the user 


Cross references for views, 
synonyms, and constraints owned 
by the user 


Database links owned by the user 
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View 


Description 





USER_EXTENTS 


USER_FREE_SPACE 


ca 


SER_INDEXES 
SER_IND_COLUMNS 


a 


USER_OBJECTS 
USER_SEGMENTS 


USER_SEQUENCES 
USER_SYNONYMS 
USER_TABLES 
USER_TABLESPACES 
USER_TAB_AUDIT_OPTS 


USER_TAB_COLUMNS 


USER_TAB_COMMENTS 





USER_TAB_GRANTS 


USER_TAB_GRANTS_MADE 
USER_TAB_GRANTS_RECD 


USER_TS_QUOTAS 
USER_USERS 
USER_VIEWS 
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Extents comprising segments 
owned by the user 


Free extents in tablespaces 
available to the user 


Indexes owned by the user 


Columns comprising the user’s 
indexes or indexes on the user’s 
tables or clusters 


Objects owned by the user 


Storage allocated for segments 
owned by the user 


Sequences owned by the user 
The user’s private synonyms 
Tables owned by the user 
Tablespaces available to the user 


Auditing options for user’s tables 
and views 


Columns of user’s tables, views, 
and clusters 


Comments on the user’s tables 
and views 


Grants on objects for which the 
user is the owner, grantor, or 
grantee 

Grants on objects owned by the user 


Grants on objects for which the 
user is the grantee 


Tablespace quotas for the user 
Privileges of the current user 
Views owned by the user 


EL 
Data Dictionary Abbreviations 


Many of the Data Dictionary views have long names. Public synonyms 
have been provided as abbreviations of some of the more common user 
Data Dictionary views. 


Abbreviations include: 


Abbreviation 


CAT USER_CATALOG 

CLU USER_CLUSTERS 
COLS USER_TAB_COLUMNS 
DICT DICTIONARY 

IND USER_INDEXES 
MYPRIVS USER_USERS 

OBJ USER_OBJECTS 

SEQ USER_SEQUENCES 
SYN USER_SYNONYMS 
TABS USER_TABLES 


for the View 





The DUAL Table 


Purpose 


Example 


The DUAL table is a Data Dictionary table, rather than a view. It has 
one column, DUMMY CHAR(1), and one row with a value ’X’. The 
DUAL table is useful when you want to compute a constant expression 
with the SELECT statement. Because it only has one row, the constant 
will only be returned once. If the DUAL table had multiple rows, the 
constant would be returned once for each row. 


You can select a constant, pseudo-column or expression from any table 
that you have access to, but for convenience, you may select from the 
DUAL table. 


DUAL is built when the Data Dictionary views are created. The DUAL 
table is owned by SYS and may be accessed by all users. 


To display the current date: 
SELECT SYSDATE FROM DUAL 
You could have easily selected SYSDATE from the EMP table, but 14 


rows of the same SYSDATE would have been returned, one for every 
row of the EMP table. DUAL is preferred because it always has one row. 
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APPENDIX 


SOL SYNTAX 


his appendix lists the syntax of each SQL statement alphabetically. 
For a complete description of each statement, refer to Chapter 5 
"SQL Statement Reference" of this Manual, 


SQL Syntax B-1 


ALTER CLUSTER 


ALTER DATABASE 


ALTER INDEX 


ALTER ROLLBACK 
SEGMENT 


ALTER SEQUENCE 


| ALTER SESSION 


ALTER TABLE 


ALTER CLUSTER [user.]cluster 

PCTUSED integer] [PCTFREE integer 
SIZE integer] 

INITRANS integer} [MAXTRANS integer 
STORAGE storage} 


ALTER DATABASE [ database } 

{ADD LOGFILE filespec {, filespec ] 

DROP LOGFILE ‘filename’ {,'’filename'] ... 

RENAME FILE ‘filename’ [,’filename’} ... 
TO ‘filename’ [,’filename'] ... 

ARCHIVELOG 

NOARCHIVELOG 

MOUNT [EXCLUSIVE | SHARED] 

DISMOUNT 

OPEN 

CLOSE [NORMAL | IMMEDIATE] } 


ALTER INDEX [user.]index 
INITRANS integer] [MAXTRANS integer] 
STORAGE storage] 





ALTER [PUBLIC] ROLLBACK SEGMENT rollback_segment 


STORAGE storage 


ALTER SEQUENCE [user.] sequence 
[INCREMENT BY integer) 
{MAXVALUE integer | NOMAXVALUE] 
[MINVALUE integer | NOMINVALUE] 
(CYCLE | NOCYCLE) 

{CACHE integer | NOCACHE] 
[ORDER | NOORDER] 


ALTER SESSION 
SET SQL_TRACE {TRUE|FALSE} 


ALTER TABLE [user.]table 
[ADD { {column_element | table_constraint} 


(. {column_element | table_constraint} ]..+ ) J 
wed] 


{MODIFY (column_element [,column_element] 
[DROP CONSTRAINT constraint] 

[PCTFREE integer] [PCTUSED integer] 
[INITRANS integer] [MAXTRANS integer 
(STORAGE storage] 

(BACKUP} 
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ALTER TABLESPACE 


ALTER USER 


AUDIT (Form I) 


AUDIT (Form II) 


CLOSE cursor 
(Embedded SQL) 


Column Constraint 


Column Element 


COMMENT 


COMMIT 


COMMIT 
(Embedded SQL) 


ALTER TABLESPACE tablespace 

ADD DATAFILE filespec [, filespec] 

RENAME DATAPILE ‘filename’ [,'filename’] ... 
TO ‘filename’ [,‘filename’] ... 

DEFAULT STORAGE storage 

ONLINE 

OFFLINE [NORMAL| IMMEDIATE] 

{BEGIN{END } BACKUP} 


ALTER USER username [IDENTIFIED BY password] 
DEFAULT TABLESPACE tablespace] 
TEMPORARY TABLESPACE tablespace] 


AUDIT {system_option [,system_option})... | ALL 
WHENEVER [NOT] SUCCESSFUL] 


AUDIT {table _option.[,table option]... | ALL} 
ON { {user.]table | DEFAULT} 

BY {SESSION | ACCESS)] 

WHENEVER [NOT] SUCCESSFUL] 








EXEC SQL CLOSE cursor_name 


{ NULL | NOT NULL [ CONSTRAINT constraint_name ] ] 
{ { UNIQUE | PRIMARY KEY } ( CONSTRAINT constraint_name ] ] 
[ REFERENCES [ user. ] table [ ( column ) } 
(CONSTRAINT constraint_name] ] 
( CHECK ( condition ) [ CONSTRAINT constraint_name) 


column datatype [DEFAULT expr] {column constraint] 


COMMENT ON { TABLE [user.]table 
| COLUMN [user.]table.column } 
TS ‘text’ 


COMMIT [WORK] 


EXEC SQL [AT dbname] COMMIT [WORK] [RELEASE] 
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CONNECT EXEC SQL CONNECT :user_password 
(Embedded SQL) AT dbname] 


USING :dbstring}; 


or 


EXEC SQL CONNECT :user IDENTIFIED BY :pass 
AT dbname) 
USING :dbstring. 


CREATE CLUSTER CREATE CLUSTER [user.]cluster 

(column datatype [,column datatype] ... } 
PCTUSED integer] [PCTFREE integer] 

SIZE integer] 
INITRANS integer] [MAXTRANS integer] 
TABLESPACE tablespace} 

STORAGE storage 





CREATE DATABASE — cReaTE DATABASE [database] 

CONTROLFILE REUSE] 

LOGFILE filespec [,filespec] ...] 
MAXLOGFILES integer 

DATAFILE filespec [{,filespec) ...] 
MAXDATAFILES integer] 
MAXINSTANCES integer] 

ARCHIVELOG | NOARCHIVELOG] 
EXCLUSIVE] 


CREATE DATABASE — cREATE [PUBLIC] DATABASE LINK link 
LINK CONNECT TO user IDENTIFIED BY password] 
USING ‘connect string’ 





CREATE INDEX CREATE [UNIQUE] INDEX index ON 
{table (column [ASC| DESC) {, column [ASC| DESC} ] weed} 


ICLUSTER cluster} 
[INITRANS n] [MAXTRANS n] 
[TABLESPACE tablespace] 
(STORAGE storage] 
{PCTFREE n] 

{NOSORT} 


CREATE ROLLBACK  crzare [ PUBLIC ] ROLLBACK SEGMENT rollback_segment 
SEGMENT [TABLESPACE tablespace] 


(STORAGE storage] 


B-4 SQL Language Reference Manual 


CREATE SEQUENCE 


CREATE SYNONYM 


CREATE TABLE 


CREATE 
TABLESPACE 


CREATE VIEW 


DECLARE CURSOR 
(Embedded SQL) 


DECLARE 
DATABASE 
(Embedded SQL) 


DECLARE 
STATEMENT 
(Embedded SQL) 


DELETE 


CREATE SEQUENCE [usexr.] sequence 
{INCREMENT BY nj 
[START WITH n] 
(MAXVALUE n | NOMAXVALUE]) 
([MINVALUE n | NOMINYALUE] 
(CYCLE | NOCYCLE} 
{CACHE n | NOCACHE] 
[ORDER | NOORDER] 


CREATE [PUBLIC] SYNONYM [user.] synonym 
FOR [user.]table [@databaselink] 


CREATE TABLE (user.]table 
( {colum_etement | table constraint} 
{, {column_element | table constraint} J...) 
PCTFREE n] [PCTUSEC nj 
INITRANS n] [MAXTRANS nj 
TABLESPACE tablespace] 
STORAGE storage] 
CLUSTER cluster (column (, column} ...)] 
AS query] 


CREATE TABLESPACE tablespace 
DATAFILE filespec [,filespec] 
DEFAULT STORAGE storage] 
ONLINE | OFFLINE) 





CREATE VIEW [user.jview [ (alias [,alias]...) ] 
AS query 
(WITH CHECK OPTION [CONSTRAINT constraint] ] 


EXEC SQL [AT dbname] DECLARE cursor CURSOR 
FOR {SELECT substatement | statement} 


EXEC SQL DECLARE dbname DATABASE 


EXEC SQL DECLARE statement_name STATEMENT 


DELETE [FROM] [user.]table [alias] (WHERE condition] 
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DELETE 
(Embedded SQL) 


DESCRIBE (Dynamic 
Embedded SQL: 
Method 4) 


DROP CLUSTER 


DROP DATABASE 
LINK 


DROP INDEX 


DROP ROLLBACK 
SEGMENT 


DROP SEQUENCE 
DROP SYNONYM 
DROP TABLE 


DROP TABLESPACE 


DROP VIEW 


EXECUTE (Dynamic 
Embedded SQL: 
Method 2) 


EXEC SQL [AT dbname] [FOR zhost_integer 
DELETE [FROM] table [alias] 
[WHERE {search condition | CURRENT OF cursor}] 


For bind variables: 


EXEC SQL DESCRIBE BIND VARIABLES FOR statement_name 
INTO descriptor_name 


For SELECT-list entries: 


EXEC SQL DESCRIBE [SELECT LIST FOR] statement_name 
INTO descriptor_name 


DROP CLUSTER [user.] cluster 
{INCLUDING TABLES] 


DROP [PUBLIC] DATABASE LINK link 


DROP INDEX [user.] index 


DROP {PUBLIC} ROLLBACK SEGMENT segment 


DROP SEQUENCE [user.] sequence 
DROP [PUBLIC] SYNONYM [user.] synonym 
DROP TABLE [usexr.]table 


DROP TABLESPACE tablespace 
(INCLUDING CONTENTS] 


DROP VIEW [user.] view 


EXEC SQL [AT dbname] [FOR :host_integer 
EXECUTE statement_name [USING values_list] 
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EXECUTE 
IMMEDIATE 
(Dynamic Embedded 
SQL: Method 1) 


EXPLAIN PLAN 


Filespec 


FETCH 
(Embedded SQL) 


FOR clause (Embedded 
SQL) 


GRANT (Form J) 


GRANT (Form II) 


GRANT (Form IID 


INSERT 


EXEC SQL [AT dbname] 
EXECUTE IMMEDIATE {thost string | string literal) 


EXPLAIN PLAN 
{SET STATEMENT ID = char] 
[INTO [user.]table] 
FOR sql_statement 


‘filename’ [SIZE integer (K|M]] [REUSE] 


EXEC SQL [FOR :host_integer] 
FETCH cursor_name 
INTO host_variable list 


For Dynamic SQL Method 4: 


EXEC SQL [FOR shost_integer] 
FETCH cursor_name 
USING descriptor 


FOR :host_integer 


GRANT database_priv [,database_priv] 
TO user [,user] ... 
{IDENTIFIED BY password [,password] ...] 


GRANT RESOURCE [ (quota [K|M]) ] 
ON tablespace 
TO (PUBLIC | user [,user] ...} 


GRANT {object_priv [ ,object_priv ] ...} | {ALL [PRIVILEGES] } 
ON [user.]table 
TO {user | PUBLIC} [,user]... 
(WITH GRANT OPTION} 


INSERT INTO [user.}table [ (column [,column]...) ] 
{ VALUES (value [,value]...) | query } 


SQL Syntax 


' 
i 
t 








INSERT 
(Embedded SQL) 


LOCK TABLE 


NOAUDIT (Form I} 


NOAUDIT (Form II) 


OPEN cursor 
(Embedded SQL) 


PREPARE (Dynamic 
Embedded SQL) 
RENAME 


REVOKE (Form 1) 


REVOKE (Form II) 


REVOKE (Form III) 


ROLLBACK 


ROLLBACK 
(Embedded SQL) 


EXEC SQL [AT dbname] [FOR :host_integer] 
INSERT INTO table [{ (column [,column]...) J] 
{VALUES ( values_element [,values_element]... ){| query} 


LOCK TABLE [user.]table [, [user.]table 
IN lockmode MODE [NOWAIT] 


NOAUDIT {system_option [,system_option] ... | ALL} 
[WHENEVER [NOT] SUCCESSFUL] 


NOAUDIT {option [,option] ... | ALL} 
ON { object | DEFAULT } 
{WHENEVER [NOT] SUCCESSFUL] 


EXEC SQL OPEN cursor name [USING host_variable list] 


For Dynamic SQL Method 4: 


EXEC SQL OPEN CURSOR [USING DESCRIPTOR_name] 


EXEC SQL PREPARE statement name 
FROM {:host_string|string_literal} 


RENAME old TO new 


REVOKE { [CONNECT] [,RESOURCE] [,DBA] } 
FROM user [,user] 


REVOKE space privilege ON tablespace 
PROM user [,user] 


REVOKE { object_priv [,object_priv]... | ALL } 
ON [user.]{ table | view } 
FROM { user | PUBLIC } [,user] 


ROLLBACK [‘WORK ] ( TO [ SAVEPOINT ] savepoint 


EXEC SQL [AT dbname} ROLLBACK [WORK] 
[TO [SAVEPOINT] savepoint] 
[RELEASE] 
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SAVEPOINT 


SELECT 


SELECT 
(Embedded SQL) 


SET TRANSACTION 


Storage clause 


Table constraint 


SAVEPOINT savepoint 


or in embedded SQL: 
EXEC SQL SAVEPOINT savepoint 


SELECT [ALL] DISTINCT] { * | table.* | expr [e_alias]} 
[, {table.* | expr [c_alias] } ]... 
FROM [user.Jtable [t_alias] [, [user.]table (t_alias]]... 
{ WHERE condition } 
{ CONNECT BY condition [START WITH condition] ] 
( GROUP BY expr[, expr]... [HAVING condition] ] 
( {UNION|INTERSECT|MINUS} SELECT ... ] 
[ ORDER BY {expr| position} [ASC | DESC] 
(, {expr| position} [ASC|DESC}] ]... 
[ FOR UPDATE OF column [, column]... [NOWATT] ] 


EXEC SQL [AT dbname] [FOR shost_integer] 
SELECT select list 
INTO :host_variable [,:host_variable]... 
FROM table list 
( WHERE condition ) 
{ CONNECT BY condition [START WITH condition] ] 
{ GROUP BY expr[, expr]... [HAVING condition] ] 
[ {UNION|INTBRSECT|MINUS} SELECT ... ] 
{ ORDER BY {expr{position} [ASC|DESC] 
[, {expriposition} [ASC|DESC}] ]... 
{ FOR UPDATE OF column [, column]... [NOWAIT] ] 


SET TRANSACTION {READ ONLY} 


STORAGE( [ INITIAL integer ] ( NEXT integer ] 
{ MINEXTENTS integer ] [ MAXEXTENTS integer ] 
{ PCTINCREASE integer ]} ) 


(UNIQUE | ( PRIMARY KEY (column [,column]... ) } 
[CONSTRAINT constraint ] ] 

[FOREIGN KBY (column [{,column]... ) 
REFERENCES [user.]table [{column [,column]... }] 
(CONSTRAINT constraint] ] 


[CHECK (condition) [CONSTRAINT constraint] } 


SQL Syntax 
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UPDATE UPDATE [user.]table [alias] 
SET column = expr [,column = expr] ... 
{WHERE condition] 


or 


UPDATE [user.]table [alias] 
SET (column [,column] ...) = (query) 

L, SET (column [,column] ...) = (query) ] ... 
(WHERE condition} 


UPDATE EXEC SQL [AT dbname] [FOR szhost_integer]} 
(Embedded SOL) UPDATE [user.]table 
SET column [,column]... = { (value [,value]... | query } 


{ WHERE { condition {| CURRENT OF cursor name } ] 
or 


EXEC SQL [AT dbname] [FOR shost_integer] 
UPDATE [user.]table 
SET columnl = { (value) | query } 
[, SET column2 = { (value) | query } J... 
{ WHERE {search_condition|CURRENT OF cursor name}] 


VALIDATE INDEX VALIDATE INDEX (user. ] index 


WHENEVER EXEC SQL WHENEVER (NOT FOUND | SQL ERROR | SQLWARNING} 
(Embedded SQL) {CONTINUE | GOTO label_name | STOP} 
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GLOSSARY 


alias A temporary name assigned to a table 
or a column within a SQL statement and used 
to refer to it later on in the same. 


argument An expression within the 
parentheses of a function, supplying a value 
for the function to use. 


ASCIL Aconvention for using digital data to 
represent printable characters. ASCII is an 
acronym for "American Standard Code for 
Information Interchange." 


audit To tell ORACLE to keep records of 
various aspects of its use, for example, accesses 
toa certain table. 


block The unit of database storage that 
ORACLE uses to allocate space to tables and 
indexes. The size of an ORACLE block may 
differ across different host computer’s 
operating systems. Common block sizes are 
512 bytes (characters) and 2,048 bytes. For the 
size of a block on your specific operating 
system, refer to your Installation and User's 
Guide. Same as page. 


ORACLE block size is generally a multiple of 
the host operating system block size. 


CHAR datatype An ORACLE CHAR 
datatype which may contain any printable 
character such as "A", "3", "&", or "blank." It 
may have any length from zero characters up 
to the maximum defined for that particular 
column. The CHAR column’s maximum 
length may be from 1 to 255 characters. 


clause One or more reserved words used as 
part of a SQL statement and sometimes 
followed by a parameter. For example, in the 
statement: 


SELECT DISTINCT SAL FROM EMP 
SELECT and FROM are clauses. 


cluster A database object that can contain 
one or more tables. Rows from all tables that 
have the same value for the cluster key are 
stored in the same place in the database. 


cluster columns One or more of the columns 
ina clustered group of tables that is used to 
determine which rows of those tables to store 
together. Same as Cluster Key. 


cluster index An index that you build on a 
the columns forming the cluster key. 
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collating sequence A sequence of characters 
in which every character is defined to be either 
greater than or less than every other character. 
An example is "alpha- betization”. A collating 
sequence is used for ordering and grouping 
the values of character columns. A collating 
sequence is operating system dependent and is 
based on the character set in use. Most 
operating systems use either the ASCII or 
EBCDIC character set. The collating sequence 
is also affected by the INIT.ORA parameter, 
LANGUAGE — different languages have 
different collating sequences. 


column (1) The fields representing one kind 
of data in a table; for example, the fields 
representing salary in the example table EMP. 
(2) The fields representing one kind of 
attribute data in the output result of a query. 


column constraint An integrity constraint 
placed on a specific column of a table. 


command See statement. 


commandline A line on a computer display 
where you are prompted to enter a command. 


composite key A primary or foreign key 
composed of two or more columns. 


concatenation Joining together of char 
values, represented by the operator "| 1" (not 
to be confused with table joins). For example, 
concatenation of the char constants ‘ABC’ and 
"XYZ’ would be denoted ‘ABC’ | | ‘XYZ’, and 
the resulting value would be ’ABCXYZ’. 


condition An expression whose value 


evaluates to either TRUE or FALSE, such as X 
> 100. 
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connect To identify yourself to ORACLE by 
your username and password, in order to 
access the database. 


CONNECT BY Optional clause of the 
SELECT statement. 


constraint see integrity constraint. 


correlated query A subquery that is 
executed repeatedly, once for each value of a 
candidate row selected by the main query. The 
outcome of each execution of the subquery 
depends on the values of one or more fields in 
the candidate row; that is, the subquery is 
correlated with the main query. 


database One or more operating system files 
in which ORACLE stores tables, views, and 
other objects; also, the set of database objects 
used by a given application. 


Database Administrator (DBA) An 
ORACLE user authorized to grant and revoke 
other users’ access to the system, modify 
ORACLE options that affect all users, and 
perform other administrative functions. Often 
called the DBA. 


database link An object stored in the local 
database which identifies a remote database, a 
communication path to the remote database, 
and optionally, a username and password for 
it. Once defined, the database link is used to 
perform queries on tables in the remote 
database. 


database object Something created and 
stored in a database. Tables, views, synonyms, 
indexes, sequences, clusters, and columns, are 
all types of database objects. 


database specification An alphanumeric 
code that identifies an ORACLE database, 
used to specify the database in SQL*Net 
operations and to define a database link. 


Data Dictionary A set of views and tables 
that contain information about database 
objects, users, privileges, events and use. 


datatype Any one of the standard forms of 
data that ORACLE can store and manipulate. 
The standard ORACLE datatypes are: CHAR, 
DATE, NUMBER, LONG, RAW, and LONG 
RAW. 


dataindependence The property of 
well-defined tables that allows the physical 
and logical structure of a table to change with- 
out affecting applications that access the table. 


DATE datatype One of the standard 
ORACLE datatypes. A DATE column may 
contain a date and time between January 1, 
4712 BC to December 31, 4712 AD. 


DBA See Database Administrator (DBA). 


deadlock A situation in which each of two 
or more users has the exclusive use of a 
resource that the other user needs to proceed. 
For example, a deadlock occurs when two 
users place locks on different tables, and then 
each attempts to use the table that the other 
has locked. ORACLE has provisions for 
automatically avoiding and resolving 
deadlocks. 


default A clause or option value that is used 
if no alternative is specified. 


entity A person, place, or thing represented 
by a table. In a table, each row represents an 
entity. 


Entity - Relationship model A framework 
used to model systems for a relational data- 
base. Divides all elements of a system into two 
categories: entities or relationships. 


equi-join A join where the join comparison 
operator is an equality, such as 
WHERE EMP.DEPTNO = DEPT.DEPTNO 


exclusive lock A lock that permits other 
users to query data, but not change it. It differs 
from a SHARE lock because it does not permit 
another user to place any type of lock on the 
same data; several users may place SHARE 
locks on the same data at the same time. 


expression One or more data items 
combined with operators or functions in a 
command. Yields a number, char, or date 
value. 


extent A part of the contiguous storage 
occupied by a table or index that is allocated at 
one time, either when the table or index is 
created or when it requires additional space. 


field Generally synonymous with a column, 
but often used to mean an actual column value. 


foreign key One or more columns whose 
values are based on the primary key values 
from another table. 


format model A clause that controls the 
appearance of numbers, dates and character 
strings. Format models for DATE columns are 
used in date conversion functions such as 
TO_DATE. 
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function An predefined operation, such as 
"convert to upper case", which may be 
performed by placing the function’s name and 
arguments in a SQL statement. 


group function A function that computes a 
single summary value (such as sum or 
average) from the individual values in 
specified groups of like values. 


host A computer on which the ORACLE 
RDBMS is running. 


index A database object that enables fast, 
direct access to rows without scanning the 
entire table. An index has an entry for each 
value found in the table’s indexed field(s), and 
pointer(s) to the row(s) having that value. 


integrity constraint A rule that restricts the 
range of valid values for a column. Placed ona 
column when the table is created. See also 
column constraints or table constraints. 


join 1. A query which retrieves data from 
two or more tables. 2. The condition(s) you 
specify to determine which rows in the tables 
will be retrieved. 


joincolumn A column used to join one table 
to another. You identify a join column by 
using it ina WHERE clause that specifies the 
relationship between the join columns in the 
two tables. 


key Acolumn or columns used to identify 
rows. Not the same as an index. See primary 
key, foreign key, unique key. 


keyword A portion of the syntax description 
that must be entered exactly as shown. 


leaf Ina tree-structured table, a row that has 
no children row. 
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level Ina tree-structured table, the number 
of rows between a given row and the root row. 
The root row is considered to be level 1, its 
children rows are level 2, and so on. 


lock To temporarily restrict other users’ 
access to data. The restriction that is placed on 
such data is called “a lock." 


logicalexpression An expression whose 
value evaluates to either TRUE or FALSE. A 
synonym for condition. 


LONG datatype A standard ORACLE 
datatype which may contain any printable 
characters such as "A", "3", "&", or "blank." It 
may have any length from 0 to 65,535 
characters. Only one LONG column may be 
defined per table. LONG columns may not be 
used in functions arguments, expressions, or 
WHERE clauses, and have certain other 
restrictions. 


LONG RAW datatype ALONG RAW 
column contains raw binary data, but is 
otherwise the same as a LONG column. Values 
entered into long raw columns must be in hex 
notation. 


nesting The practice of placing a query 
within another statement or clause. 


network A connection among two or more 
different computers which enables them to 
exchange information directly. 


node 1. In tree-structured table, one row. 2. 
In a network, a location in the network where 
a computer is attached. 


non-equi-join A join condition that specifies 
a relationship other than equality (=). 





null A value which means, "a value is not 
applicable" or "the value is unknown." A query 
can select or ignore rows with null values in 
particular fields. Group functions generally 
ignore null values. Nulls are not equal to any 
specific value, even to each other. 
Comparisons with nulls are always FALSE, 


NUMBER datatype A standard ORACLE 
datatype that may contain a number, with or 
without a decimal point and a sign. Its size 
may be defined from 1 to 105 decimal digits 
(only 38 are significant), 


operating system A computer program that 
manages the computer's resources and 
mediates between the computer hardware and 
programs. 


Operator A character or reserved word used 
in an expression to perform an operation, such 
as addition or comparison, on the elements of 
the expression. Some examples of operators 
are * (multiplication), > (greater than 
comparison), and ANY (compares a value to 
each value returned by a subquery). 


outerjoin A type of join that returns those 
tows from one table of the join that do not 
satisfy the join condition, in addition to those 
that do satisfy the condition, Zach preserved 
row is joined to an imaginary row in the other 
table in which all the fields are null. 


page A unit of disk storage; see block. 


parentquery The outermost query (the one 
that displays a result) ina query containing a 
subquery. 


password A set of characters that you must 
enter when you connect to your host 
computer’s operating system or to an 


ORACLE database. Passwords should be kept 
confidential. 


physical bleck _A storage location on a disk. 
Often 512 bytes. Different from an ORACLE 
block; see block. 


precedence The default order in which 
ORACLE performs operations in an 
expression. In the expression "2+3"X", 3*X is 
computed first, then 2 is added, because 
multiplication (*) has a higher precedence than 
addition (+). 


primary key The column(s) used to uniquely 
identify each row of a table. 


privilege Any one of the operations that the 
creator of a table may grant another user the 
right to perform on that table. The privileges 
recognized by ORACLE are ALTER, DELETE, 
INDEX, INSERT, REFERENCE, SELECT, and 
UPDATE. The keyword ALL is used to grant 
all of the grantor’s privileges, 


pseudo-column A "column" which yields a 
value when selected, but which is not an actual 
column of the table, An example is ROWID. 


public 1) Visible or availabe to all users. 
Synonyms and database links can be public. 
Only DBAs can create public objects, Any user 
may GRANT PUBLIC access to his own 
objects. 2) A group to which every database 
user belongs - the name of that group. 


query A SQL instruction to retrieve data 
from one or more tables or views. Queries 
begin with the SQL keyword SELECT. 


RAW datatype A RAW column contains 
binary data in whatever form the host 
computer stores it. Raw columns are useful for 
storing binary (non-character) data. 
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read consistency A state that guarantees that 
all data encountered by a statement/ 
transaction is a consistent set throughout the 
duration of the statement/transaction. See SET 
TRANSACTION statement. 


record Asynonym for row. 


referentialintegrity The property that 
guarantees that values from one column 
depend on values from another column. This 
property is enforced through integrity 
constraints. 


referential integrity rule An integrity 
constraint that enforces referential integrity. 


relation See fable. 


Relational Database Management System 

A computer program for general-purpose data 
storage and retrieval which organizes data into 
tables consisting of one or more units of 
information (rows), each containing the same 
set of data items (columns). ORACLE is a 
relational database management system. 


remote computer A term used to refer to any 
computer in a network other than one’s own 
host computer. 


remote database A database that resides on 
a remote computer; in particular, one that you 
use through a database link. 


RDBMS __ See Relational Database Management 
System. 


reserved word A word that has a special 
meaning to SQL, and therefore may not be 
used as the name of an object. Contrasted to 
keyword, which may be used as an object name, 
but may become a reserved word in the future. 
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_ session The events that happen between the 


rollback segment A storage space within a 
tablespace that holds transaction information 
used to guarantee data integrity during a 
rollback and used to provide read consistency 
across multiple transactions. 


root Ina table with tree-structured data, the 
origin of the tree; a row that has no parent, and 
whose children, grandchildren, etc., constitute 
the entire tree. In a tree-structured query, the 
row specified by the START WITH clause ina 
tree-structured query. 


row (1) One set of fields in a table; for 
example, the fields representing one employee 
in the example table EMP. (2) One set of fields 
in the output of a query. 


ROWID The internal address of arow ina 
table. A row’s ROWID can be retrieved in a 
SELECT command with the pseudo-column 
ROWID. It can be converted with the functions 
ROWIDTOCHAR and CHARTOROWID. 


savepoint A point within a transaction to 
which you may rollback. Savepoints allow you 
to rollback portions of your current 
transaction. See the ROLLBACK statement. 


sequence A database object used to generate 
unique integers for use as primary keys. 


time a user connects to SQL and the time he or 
she disconnects. 


setcondition A logical expression 
containing a query, for example: 


‘JOB IN (SBLECT... )'. 


setoperator One of UNION, INTERSECT, or 
MINUS. ; 


share lock A lock that permits other users to 
query data, but not change it. 





share update lock A lock that permits other 
users to both query and lock data. 


soundex A character function used to 
represent the sound of a word in a character 
value. Soundex codes can be used to help a 
query find the desired rows even if it misspells 
the word (for example, searching for "SMITH" 
and finding "SMYTHE"). 


SQL The ANSI, industry-standard language, 
used to manipulate information in a relational 
database. SQL is the language used in 
ORACLE and IBM DB2 relational database 
management systems. SQL is pronounced 
"sequel". 


SQL*Net An optional product that works 
with the ORACLE RDBMS to enable two or 
more computers running ORACLE to 

exchange database data through a network. 


subquery A query that is used in 
parentheses in a clause of a SQL command. See 
correlated query. 


statement A SQL instruction to ORACLE 
comprised of clauses. 


synonym A name assigned toa table or view 
that may then be used more conveniently to 
refer to it. If you have access to another user’s 
table, you may create a synonym for it and 
refer to it by the synonym alone, without 
entering the user’s name as a qualifier, 


syntax A set of rules that determine how to 
construct a valid statement in a computer 
language like SQL. 


table The basic data storage structure ina 
relational database management system. A 
table consists of one of more units of 


information (rows), each of which contains the 
same kinds of values (columns). 


table alias; A temporary substitute for a 
table name, defined in the FROM clause of a 
SELECT statement. 


table column A column that appears ina 
table. See column. 


table constraint An integrity constraint that 
applies to multiple columns of the same table. 
See column constraint. 


tablespace A file or set of files that is used to 
store ORACLE data. An ORACLE database is 
composed of the SYSTEM tablespace and 
possibly other tablespaces. 


temporary segment A storage space within a 
tablespace used to hold intermediate results of 
a SQL statement. For example, temporary 
segments are used when sorting large tables. 


transaction A sequence of SQL statements 
that ORACLE treats as a single unit. The set of 
changes is made permanent with the COMMIT 
statement. Part or all of a transaction can be 
undone with the ROLLBACK statement. 


tree-structured query A query whose result 
shows hierarchical relationships among rows 
in a table. See CONNECT BY. 


tuple Synonym for row. 


unique key One or more columns that must 
be unique for each row of the table. See key, 


primary key. 


username A word that identifies you as an 
authorized user of your host computer's 
operating system or of ORACLE. Associated 
with each username is a password. 
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view A database object that is a logical 
representation of a table. It is derived froma 
table but has no storage of its own and often 
may be used in the same manner as a table. 


virtual column A column ina query result 


whose value is calculated from the value(s) of 
other column(s). 
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'= comparison operator 4-3 
$ number format element 4-36 
% character 


in pattern matching 4-9 to 4-10 
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Data Dictionary A-7 
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ALL comparison operator 
definition 4-3 
examples 4-3 
ALL option 
of AUDIT statement 5-22, 5-24 
of group functions 4-20 
of NOAUDIT statement 5-113 to 5-114 
of SELECT statement 4-8, 5-128 to 5-129 
Allocation of cluster blocks 5-8 
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ALTER CLUSTER statement 
definition 5-7 to 5-8 
summary 5-2 
syntax 5-7, B-2 

ALTER DATABASE statement 
definition 5-9 to 5-11 
summary 5-2 
syntax 5-9, B-2 

ALTER INDEX statement 
definition 5-12 
summary 5-2 
syntax 5-12, B-2 

ALTER object privilege 5-105 

ALTER ROLLBACK SEGMENT statement 
definition 5-13 
summary 5-2 
syntax 5-13, B-2 

ALTER SEQUENCE statement 
definition 5-14 to 5-15 
example 5-15 
summary 5-2 
syntax 5-14, B-2 

ALTER SESSION statement 
definition 5-16 
summary 5-2 
syntax 5-16, B-2 

ALTER TABLE statement 
datatype specification 3-9 
definition 5-17 to 5-18 
modify columns 1-5 
summary 5-2 
syntax 5-17, B-2 

ALTER TABLESPACE statement 
definition 5-19 to 5-20 
example 5-20 
summary 5-3 
syntax 5-19, B-3 

ALTER USER statement 
definition 5-21 
example 5-21 
summary 5-3 
syntax 5-21, B-3 

AM date format element 4-37 

AND 
operator in a condition 4-42 
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AND logical operator 
definition 4-5 
in WHERE clause 6-6 
truth table 4-5 
ANSI 
"end of fetch" return code 5-110 
American National Standards Institute 1-14, 
2-2 
ANY comparison operator 
definition 4-3 
examples 4-3 
Appearance of displayed data, controlling 
4-34 
Archive 
redo log files 5-9 
ARCHIVELOG 
option of CREATE DATABASE 5-49 
Argument 1-1 
definition 4-11 
Arithmetic operator 4-2 
Arrays 
in a FETCH statement 5-99 
in an embedded SQL INSERT statement 5-109 
in an embedded SQL SELECT statement 
5-134 
in an embedded SQL UPDATE statement 
5-143 
storing 3-16 
AS clause 
CREATE TABLE statement 5-67 
CREATE VIEW statement 5-74 
ASC option 
of CREATE INDEX statement 5-52 
of ORDER BY clause 6-11 
Ascending order 6-11 
ASCII 1-1 
char function 4-19 
collating sequence 3-20 to 3-21 
data 3-9 
function 4-19 





AT clause 
See also DECLARE DATABASE statement 
definition 2-6 
of embedded SELECT statement 5-133 
of embedded UPDATE statement 5-142 
of FETCH statement 5-31 

Audit 1-1 

AUDIT statement 
auditing views 5-76 
definition 5-22 to 5-25 
examples 5-23, 5-25 
how much auditing 5-25 
results in Data Dictionary tables 5-22 
reversing effects of 5-113 
summary 5-3 
syntax 5-22, 5-24, B-3 

Authority, granting to user 5-102 

AVG group function 4-20 


B 


B number format element 4-36 
B.C, date format element 4-36 
Backup 

for a table 5-17 
BC date format element 4-36 
BETWEEN comparison operator 

definition 4-4 

inacondition 4-43 
Binary data 

storing with LONG or LONG RAW 3-17 
Block 1-1 
Block size 

effect on PCTINCREASE 5-138 
Blocks 

in ROWID 3-18 
Boolean expressions 3-19 
BY ACCESS auditing option 5-24 
BY SESSION auditing option 5-24 


Cc 


CACHE 
option of CREATE SEQUENCE 5-59, 5-61 
Capitalization 
date formatting 4-38 
Cartesian product 
definition 6-14 
Case 
significance in pattern matching 4-9 
CATALOG Data Dictionary view 
COMMENT statement 5-28 
CC date format element 4-36 
CEIL 
number function 4-12 
Century 
storing 3-15 
Chained rows 
definition 5-68 
Change display format 
format model 4-34 
Char 1-1 
comparison rules 3-20 
datatype 3-23 
format model 4-34 
pattern 4-9 
CHAR data 3-23 
CHAR datatype 3-10, 3-17 
description of 3-9 
maximum characters 3-10 
Character 
comparison rules 3-20 
functions 4-14 
literal 3-8 
operator 4-3 
Character data 3-10 
CHARACTER datatype 3-23 
Character set 
allowable 3-9 
CONVERT function 4-23 
for National Language Support 4-24 
CHARTOROWID 
conversion function 4-23 
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CHECK 
column constraint 5-35 
constraint, example 5-40 
CREATE VIEW option 5-74 
Child node 
definition 3-27 
CHR character function 4-14 
Clause 1-1 
CLOSE cursor statement 
definition 5-26 
embedded SQL syntax 5-26, B-3 
examples 5-26 
summary 5-3 
Close database 
ALTER DATABASE 5-9 
Cluster 1-1 
atable 5-66 
adding tables to 5-45 
changing future storage allocation 5-8 
column 1-1 
column, definition 5-43 
constraints 5-44 
CREATE TABLE option 5-70 
creating 3-17 
creating index for 5-52 
definition 1-8 
dropping from database 5-85 
index 1-1 
index, definition 5-45 
key, definition 5-43 
moving to a different tablespace 5-8 
order of columns 5-44 
removing a table 5-85 
removing tables from 5-8 
SIZE 5-44 
storage allocation 5-137 
CLUSTER clause 
CREATE TABLE statement 5-42 
Cluster key 5-43 
CLUSTER option 
of CREATE INDEX statement 5-52 
Cluster:Index 5-55 
COL Data Dictionary view 
COMMENT statement 5-28 
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Collating sequence 1-2 

ASCII 3-20 

definition 3-20 

EBCDIC 3-22 

returned by NLSSORT function 4-20 

value returned by ASCII function 4-19 
Column 1-2 

adding comments to 5-28 

adding new or modifying 5-17 

adding to definition of table 5-18 

alias 5-128 

aliases, for a view 5-76 

belonging to multiple columns 5-39 

comment, inserting into Data Dictionary 5-28 

default when inserting 5-107 

grant access to 5-105 

identifying 1-4 

index, definition 5-53 

indexing 5-53 

maximum number in a table 5-70 

names, for a view 5-75 

names, specifying in CREATE TABLE 5-67 

number of columns per index 5-53 

order of 1-4 

position within a table 5-107 

pseudo-column 3-26 

qualifying names with table/owner name 

5-129 

renaming 5-118 

renaming with a view 5-75 

selecting from table 5-128 

static nature of 1-5 

table design 1-3 to 1-4 
Column constraint 1-2 

definition 1-14, 5-35 to 5-41, B-3 i 

for primary key 1-10 

restrict range of valid column values 5-35 

syntax 5-35 
Column element 

definition 5-27, B-3 

syntax 5-27 

syntax element of CREATE TABLE 5-66 
Column:column constraints 5-36 
Column:table constraints 5-36 


COLUMNS Data Dictionary view 
COMMENT statement 5-28 
Comma number format element 4-36 
Command 1-2 
Command line 1-2 
Comment 
dropping from database 5-28 
SQL, definition 5-6 
COMMENT statement 5-28 
definition 5-28 
summary 5-3 
syntax 5-28, B-3 
COMMENTS column 
Data Dictionary views 5-28 
COMMIT statement 
definition 5-29 to 5-31 
See also Embedded SQL COMMIT statement 
embedded SQL syntax 5-31, B-3 
ending a transaction 5-123, 5-127, 5-136 
examples 5-30 to 5-31 
releasing locks 5-131, 5-140 
results of 5-29 
summary 5-3 
syntax 5-29, B-3 
Comparison operators 4-3 
Comparison rules 3-20 
Composite 
foreign key 1-11 
primary key 1-10 
Concatenation 1-2 
Concatenation operator 4-3 
Condition 
definition 1-2, 4-42, 6-6 
example 4-42 
multiple 4-42 
syntax description 4-42 
where used 4-42 
Conditional clause 6-6 
Connect 1-2 
CONNECT BY 1-2 


CONNECT BY clause 
CREATE DATABASE LINK statement 5-51 
definition 6-9 
LONG data in 3-16 
of SELECT statement 5-129 to 5-130, 6-9 
restrictions with remote tables 6-21 
CONNECT database 
in GRANT statement 5-101 
CONNECT database privilege 
in REVOKE statement 5-119 
CONNECT statement 
AT clause 5-133 
definition 5-32 to 5-34 
direct 5-33 
embedded SQL syntax 5-32, B-4 
examples 5-34 
indirect 5-34 
multiple 5-32 
summary 5-3 
Constraint 1-2 
adding or dropping, ALTER TABLE 5-17 
as defined in “column element" 5-27 
CHECK 5-35 
column 1-2, 5-36 
column definition 5-35 to 5-41, B-3 
default name 5-36, 5-74 
example 5-37 
foreign key/references 5-35 
forms of 1-14 
in CREATE TABLE 5-71 
modifying 5-67 
NOT NULL 5-35 
PRIMARY key 5-35 
table 5-36, 5-66 
table definition 5-35 to 5-41 
8 Of 5-36 
ORIQUE key 5-35 
use in ALTER TABLE statement 5-37 
use in CREATE TABLE statement 5-37 
WITH CHECK OPTION constraint 5-74 


Constraints 


support for 1-14 


CONTINUE 


WHENEVER statement action 5-146 


Index - 5 





Control file 
in CREATE DATABASE 5-48 
Conversion functions 4-23 
CONVERT 
function, National Language Support 2-4 
Converting data 3-19 
Correlated query 1-2, 5-129 
definition 6-18 
Correlated subquery 5-139, 6-19 
Correlated update 
definition 5-140 
COUNT 
operator 4-8 
COUNT group function 4-21 
CREATE CLUSTER statement 
datatype specification 3-9 
definition 5-42 to 5-46 
examples 5-46 
summary 5-3 
syntax 5-42,B4 
CREATE DATABASE LINK statement 
definition 5-50 to 5-51 
examples 5-51 
summary 5-3 
syntax 5-50, B4 
CREATE DATABASE statement 
definition 5-47 to 5-49 
examples 5-49 
summary 5-3 
syntax 5-47, B-4 
CREATE INDEX statement 
definition 5-52 to 5-56 
examples 5-56 
summary 5-3 
syntax 5-52, B-4 
CREATE ROLLBACK SEGMENT statement 
definition 5-57 
examples 5-57 
summary 5-3 
syntax 5-57, B4 
CREATE SEQUENCE statement 
definition 5-58 to 5-63 
examples 5-62 
summary 5-3 
syntax 5-58, B-5 
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CREATE SYNONYM statement 


definition 5-64 to 5-65 
examples 5-65 
summary 5-3 

syntax 5-64, B-5 


CREATE TABLE statement 


datatype specification 3-9 
definition 5-66 to 5-71 
examples 5-71 

summary 5-3 

syntax 5-66, B-5 


CREATE TABLESPACE statement 


definition 5-72 to 5-73 
examples 5-73 
summary 5-3 

syntax 5-72, B-5 


CREATE VIEW statement 


definition 5-74 to 5-77 
examples 5-76 
statement B-5 
summary 5-3 

syntax 5-74 


Creating a savepoint 5-126 
CURRENT OF clause 


in WHERE clause 6-7 to 6-8 

in WHERE clause of UPDAT& statement 
5-143 

use in DELETE statement 5-32 


CURRVAL 


argument of sequence generation 5-62 
pseudo-column 3-26 

restrictions on use 5-62 

use in expression 4-40 

used in same statement with NEXTVAL 5-63 


Cursor 


distinct names 5-78 
evaluate query, OPEN 5-115 
in FETCH statement 5-98 
position after FETCH 5-99 


CYCLE 


option of CREATE SEQUENCE 5-59 





D 


D date format element 4-37 
Data 

controlling appearance of displayed 4-34 
Data complexity 

hiding with a view 5-75 

reduction of 1-7 
Data consistency 

via integrity constraints 1-13 
Data conversion 3-19 
Data Definition Language (DDL) 5-2 
Data Dictionary 1-3 

abbreviations A-7 

AUDIT tables 5-22 

definition A-1 

effect of CREATE TABLE statement 5-70 

inserting comment into 5-28 

LONG data used in 3-16 

sequence information 5-60 

to record constraint definitions 5-36 
Data independence 1-3 

logical 1-9 

of clusters 1-9 

physical 1-9 

via synonyms 5-64 

with respect to rows 1-6 
Data Manipulation Language (DML) 5-2 
Database 

creation of 5-47 to 5-49 


setting number of instances, database files or 


redo log files 5-47 
adding/renaming files 5-19 
cluster 1-1 


creating link between local and remote 5-50 


definition 1-2 

deleting cluster from 5-85 

deleting index from 5-87 

deleting rollback segments from 5-88 
deleting synonym from 5-90 

deleting table from 5-91 

deleting view from 5-93 

disconnecting from, embedded SQL 5-125 
dropping comment from 5-28 

dropping of tablespace 5-92 


granting access to 5-101 
link name 6-20 


link restrictions, queries & subqueries 5-51 


mounting 5-9 

naming files 5-47 

opening/closing 5-9 

privileges, revoking 5-119 to 5-121 

remote connection 5-33 

remote, accessing data in 6-20 

remote, logging onto 6-21 

specification 1-3 

storage allocation 5-137 
Database link 1-2 

creation of 5-50 to 5-51 

dropping 5-86 

example 5-51 

for synonyms 5-64 

FROM clause 6-2 

omitting username 5-50 

public 5-50 

remote connection 5-34 

use with synonyms 5-51 
Database object 1-3 

definition of 3-2 


effect of revoking database privileges 5-119 


naming guidelines 3-4 
naming rules 3-3 
Database objects 
naming 3-2 
DATAFILE 
CREATE TABLESPACE option 5-72 
option of CREATE DATABASE 5-48 
Datatype 
CHAR 1-1 
comparison rules 3-20 
conversion 3-9 
conversion table 3-19 
conversions 3-19 
DATE 1-3 
definition 1-3 
definition of 3-9 
mixing 3-19 
of a condition 4-42 
of an expression 4-39 
Specified in a column element 5-27 
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SQL/DS or DB2 3-17 
summary 3-23 
Date 
comparison rules 3-20 
data 3-23 
datatype 1-3, 3-23 
default 3-15 
format model 4-34, 4-36 
formats 4-36 
literal 3-8 
DATE datatype 3-15 
julian 3-16 
Date format 
default 3-15 
DATE number format element 4-36 
DAY date format element 4-37 
DB2 
and SQL 2-2 
datatypes 3-17 
DB2 datatypes 3-17 
DBA 1-3 
range of privileges 5-102 
DBA database privilege 
in GRANT statement 5-101 
in REVOKE statement 5-119 
of AUDIT statement 5-22 
DBlink 
See Database link 
dbname 2-6 
DD date format element 4-37 
DDD date format element 4-37 
DDL 
See Data Definition Language (DDL) 
Deadlock 1-3 
DECIMAL datatype 3-17 
Decimal places 3-11 
negative 3-11 
DECLARE CURSOR statement 
definition 5-78 
embedded SQL syntax 5-78, B-5 
preceding FETCH statement 5-98 
summary 5-4 
used with SELECT statement 5-134 
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DECLARE DATABASE statement 
definition 5-79 
embedded SQL syntax 5-79, B-5 
summary 5-4 
DECLARE STATEMENT statement 
definition 5-80 
embedded SQL syntax 5-80, B-5 
examples 5-80 
scope of 5-80 
summary 5-4 
when required 5-80 
Declaring a cursor 5-78 
DECODE 
function 4-30 
DEFAULT 1-3 
clause of column element 5-27 
cluster key 5-56 
columns for REFERENCES constraint 5-39 
sequence defaults 5-60 
tablespace 5-73 
tablespace defaults 5-72 
tablespace for rollback segments 5-57 
DEFAULT option 
of AUDIT statement 5-24 
of NOAUDIT statement 5-114 
DEFAULT STORAGE clause 
of CREATE TABLESPACE statement 5-72 
Default tablespace 
fora user 5-21 
Default temporary segment 
forauser 5-21 | 
DELETE object privilege 5-105 | 
DELETE statement \ 
definition 5-81 to 5-83 | 
embedded SQL examples 5-83 ; 
embedded SQL syntax 5-82, B-6 | 
examples 5-81 
summary 5-4 
syntax 5-81 to 5-82, B-5 to B-6 
used with a view 5-75 
DESC option 
of CREATE INDEX statement 5-52 
of ORDER BY clause 6-11 
Descending order 6-11 





DESCRIBE statement 
definition 5-84 
embedded SQL syntax 5-84, B-6 
example 5-84 
summary 5-4 
use with PREPARE statement 5-84 
Descriptor 
naming 5-84 
DICTIONARY 
Data Dictionary view A-2 
Disconnect from database 
ending a transaction 5-127 
with the RELEASE option of COMMIT 5-31 
with the RELEASE option of ROLLBACK 
5-125 
Dismount database 5-9 
Displayed data 
controlling appearance 4-34 
DISTINCT clause 
CREATE VIEW statement 5-76 
with ORDER BY clause 6-12 
DISTINCT operator 4-8 
DISTINCT option 
of group functions 4-20 
of SELECT statement 5-128 to 5-129 
SELECT statement 5-131 
Distinct values 
of cluster key 5-43 
Distributed queries 
LONG data in 3-17 
restrictions on 6-21 
Distributed query 
definition 6-20 
Division operator 4-2 
DML 
See Data Manipulation Language (DML) 
Documents 
Storing 3-16 
DROP CLUSTER statement 
definition 5-85 
examples 5-85 
syntax 5-85, B-6 


DROP DATABASE LINK statement 
definition 5-86 
examples 5-86 
syntax 5-86, B-6 
DROP INDEX statement 5-87 
definition 5-87 
examples 5-87 
syntax 5-87, B-6 
Drop redo log files 
ALTER DATABASE 5-9 
DROP ROLLBACK SEGMENT statement 
definition 5-88 
examples 5-88 
syntax 5-88, B-6 
DROP SEQUENCE statement 
definition 5-89 
examples 5-89 
syntax 5-89, B-6 
DROP statement 5-4 
DROP SYNONYM statement 
definition 5-90 
examples 5-90 
syntax 5-90, B-6 
DROP TABLE statement 
definition 5-91 
examples 5-91 
syntax 5-91, B-6 
DROP TABLESPACE statement 
definition 5-92 
examples 5-92 
syntax 5-92, B-6 
DROP VIEW statement 
example 5-93 
examples 5-93 
invalidates views and synonyms which 
reference it 5-93 
syntax 5-93, B-6 
DUAL table 
definition of A-7 
DUMMY column 
of DUAL table A-7 
DUMP 
function 4-30 
Duplicate records 
using UNION, INTERSECT, MINUS 4-6 
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Duplicate values 

within a foreign key 1-12 
DY date format element 4-37 
Dynamic SQL 5-116 


E 


E number format element 4-36 

EBCDIC 
collating sequence 3-22 
data 3-9 

Elements 
date format model 4-36 - 
number format model 4-36 

EMB 
See Embedded SQL 

Embedded SQL 
UPDATE statement B-10 
CLOSE cursor statement 5-26, B-3 
COMMIT statement 5-31, B-3 
CONNECT statement 5-32 to 5-34, B-4 
DECLARE CURSOR statement 5-78, B-5 
DECLARE DATABASE statement 5-79, B-5 
DECLARE STATEMENT statement 5-80, B-5 
definition 2-5, 5-2 
DELETE statement 5-82 to 5-83, B-6 
DESCRIBE statement 5-84, B-6 
EXECUTE IMMEDIATE statement 5-95, B-7 
EXECUTE statement 5-94, B-6 
FETCH statement 5-98 to 5-99, B-7 
FOR clause 5-100, B-7 
INSERT statement 5-109 to 5-110, B-8 
OPEN cursor statement 5-115 to 5-116, B-8 
PREPARE statement 5-117, B-8 
ROLLBACK statement 5-125, B-8 
SELECT statement 5-133 to 5-134, B-9 
terms 2-6 
UPDATE statement 5-142 to 5-144 
use of variables 3-8 
WHENEVER statement 5-146 to 5-147, B-10 
WHERE clause 6-7 
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Ending a transaction 
with a COMMIT statement 5-29 
with the ROLLBACK statement 5-125 
Entity 1-3 
Entity Relationship model 1-2 
Entity - Relationship model 1-3 
Entity Relationship Model 1-2 
ENTRYID 
USERENV option 4-33 
equence 
See restarting 
See stopping 
Equi-join 1-3, 6-13 
Error detection 
See error reporting 
Error reporting 
WHENEVER statement 5-146 
Exclusive lock 1-3, 5-111 
EXCLUSIVE option 
of CREATE DATABASE statement 5-49 
EXECUTE IMMEDIATE statement 
definition 5-95 
embedded SQL syntax 5-95 
examples 5-95 
summary 5-4 
syntax B-7 
EXECUTE statement 
definition 5-94 
embedded SQL syntax 5-94 
examples 5-94 
summary 5-4 
syntax B-6 
EXISTS comparison operator 
definition 4-4 
inacondition 4-43 
EXPLAIN PLAN statement 
definition 5-96 to 5-97 
examples 5-97 
summary 5-4 
syntax 5-96, B-7 
Explicit commit or rollback 5-125 
Exponents 
representation 3-12 





Expression 1-3 
definition 4-39 
definition, syntax 4-40 
example 4-39 
number, prefix sign 4-2 
use in condition 4-42 
where used 4-39 

Extent 1-3 

Extents 
after first 5-137 to 5-138 
default values 5-137 
initial 5-137 
INITIAL size 5-137 
MAXEXTENTS limit 5-138 
maximum number of 5-138 
MINEXTENTS 5-138 
minimum number of 5-138 
NEXT size 5-137 
size of subsequent 5-138 


F 


F7DEC 
character set 4-24 
FALSE 
result of a condition 4-42 
FETCH statement 
definition 5-98 to 5-99 
embedded SQL syntax 5-98, B-7 
error code on "end of fetch" 5-99 
examples 5-99 
summary 5-4 
used after OPEN statement 5-115 
using CURRENT OF clause 5-143 
Field 1-3 
changing value in a table 5-139 
synonym for column 1-4 
File 


for tablespace 5-72 

setting number of database files with CREATE 
DATABASE 5-47 
Files 

in ROWID 3-18 


Filespec 
definition 5-9, 5-19, 5-47, 5-72 
in ADD DATAFILE clause 
of ALTER TABLESPACE 5-19 
in ADD LOGFILE clause of ALTER 
DATABASE 5-9 
in DATAFILE clause of CREATE 
TABLESPACE 5-48, 5-72 
in LOGFILE clause of CREATE DATABASE 
5-48 
syntax 5-9, 5-19, 5-47, 5-72, B-7 
Fill mode 
trims trailing blanks 4-37 
Fixed numbers 
storing 3-11 
FLOAT datatype 3-17 
Floating point numbers 
storing 3-11 
FLOOR 
number function 4-12 
FOR clause 
definition 5-100 
embedded SQL syntax 5-100, B-7 
examples 5-100 
of EXECUTE statement 5-94 
FOR UPDATE clause 
of DECLARE CURSOR statement 5-78 
of SELECT statement 5-131 
FOR UPDATE OF clause 6-12 
of SELECT statement 5-129 
of SELECT substatement 5-134 
FOREIGN 
column constraint 5-35 
Foreign key 1-3 
and nulls 1-12 
composite 1-11 
definition of 1-11 
multiple 1-11 
table design 1-3 
Format masks 3-15 
Format model 1-3 
definition 4-34 
supplying the correct format 4-35 
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Formatting 

date data 4-36 

number data 4-36 
Free block list 5-70 

description 5-68 
Freespace 

reserved by PCTFREE 5-68 
FROM 

clause 6-2 

clause, definition 6-2 

clause, example 6-3 
FROM clause 

CREATE DATABASE LINK statement 5-50 

REVOKE statement 5-121 

SELECT statement 5-130 
FROM DUAL clause A-7 
Function 1-4 

definition 4-11 

use in expression 4-39 
Functions 

character 4-14 

conversion 4-23 

group 4-20 

LONG data in 3-16 

number 4-12 


G 


GOTO 
WHENEVER statement action 5-146 
GRANT statement 
definition 5-101 to 5-106 
examples 5-102 to 5-103, 5-106 
providing access to the database 5-101 
summary 5-4 
syntax 5-101, 5-103 to 5-104, B-7 
GRAPHIC datatype 3-17 
Graphics characters 
storing 3-17 
GREATEST 
function 4-31 
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GROUP BY clause 
CREATE VIEW statement 5-76 
definition 6-3 
group functions 4-20 
LONG data in 3-16 
of SELECT statement 5-129, 5-131 
Group function 1-4, 4-20 
Group functions 
null values in 3-25 


H 


HAVING clause 

definition 6-3 

of SELECT statement 5-129, 5-131 
HEXTORAW 

conversion function 4-24 
HE date format element 4-37 
HHI12 date format element 4-37 
HH24 date format element 4-37 
HOLD_CURSOR option 

of ORACLE Precompilers 5-26 
Host 1-4 
Host variable 

embedded SQL INSERT 5-109 

in EXECUTE statement 5-94 

in the INTO list 5-133 

in the WHERE clause of the UPDATE 
statement 5-143 

OPEN statement 5-115 
Host variables 

definition 2-6 
host_string 2-6 


I 


IN comparison operator 

definition 4-3 

examples 4-3 
INCLUDING CONTENTS 

DROP TABLESPACE option 5-92 
INCLUDING TABLES 

DROP CLUSTER option 5-85 


INCREMENT BY 
option of CREATE SEQUENCE 5-58 
Index 1-4 
checking integrity in table 5-145 
cluster 5-45, 5-55 
columns 5-53 
definition of 1-8 
deleting from database 5-87 
deletion when a table is dropped 5-91 
DROP TABLE statement 5-91 
internal format 5-53 
maximum number of columns per index 5-53 
means to enforce uniqueness 1-8 
multiple per table 5-53 
naming conventions 5-54 
performance considerations 5-54 
storage allocation 5-137 
unique 5-54 
use with LIKE operator 4-10 
Index column 
definition 5-52 
INDEX object privilege 5-105 
Indexes 
LONG datatype and 3-16 
Indicator variables 
in FETCH statement 5-99 
INITCAP 
character function 4-15 
INITIAL 
Storage clause option 5-137 
INITRAN! 
CREATE TABLE option 5-69 
Inner query 
definition 6-19 
INSERT object privilege 5-105 
INSERT statement 3-16 
definition 5-107 to 5-110 
embedded SQL examples 5-110 
embedded SQL syntax 5-109, B-8 
examples 5-108 
privileges necessary 5-107 
summary 5-4 
syntax 5-107, 5-109, B-7 to B-8 
used with a view 5-75 
Inserting comments into Data Dictionary 5-28 


Inserting rows into a table 5-70 
Instance 
setting with CREATE DATABASE 5-47 
INSTR 
character function 4-19 
INTEGER 
definition 3-13 
INTEGER datatype 3-17 
Integrity constraint 1-4 
referential integrity 1-13 
Integrity Constraints 
table design 1-2 
INTERSECT set operator 4-6 
in ORDER BY clause 6-11 
with SELECT statements 5-131 
INTO clause 
of FETCH statement 5-98 
of SELECT statement 5-133 
IS [NOT] NULL comparison operator 
definition 4-4 
ISO 
International Standards Organization 2-2 


J 


J date format element 4-37 
Join 1-4 

and clusters 5-43 

outer 6-15 

simple 6-13 to 6-14 
Join column 1-4 
Julian dates 3-16 


K 


K 
integer notation 3-13 
Key 1-4 
foreign key 1-11 
generating unique 5-59 
primary key 1-10 
unique 1-12 
Keywords 
definition of 3-7 
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L 


Language 
non-procedural 2-3 
USERENV option 4-33 
Language:embedded SQL 2-5 
LAST_DAY 
date function 4-27 
Leaf 1-4 
Leaf node 
definition 3-27 
LEAST 
function 4-32 
LENGTH 
character function 4-19 
LEVEL 1-4 
pseudo-column 3-27 
LEVEL pseudo-column 
SELECT statement 5-130, 6-10 
Lexical conventions 
ORACLE SQL 2-7 
LIKE 
comparison operator 4-9 
operator 4-4 
LIKE comparison operator 
definition 4-4 
Link 
creating between local & remote databases 
5-50 
database link 5-50 
dropping database link 5-86 
Link name 
database 6-20 
Literal 
definition of 3-8 
Local database 
& remote database, creating link between 5-50 
Location Transparency 
via synonyms 5-64 


Index - 14 SQL Language Reference Manual 


Lock 1-4 
and queries 5-112 
example 5-112 
exclusive 5-111 
multiple 5-112 
release of 5-31 


released by ROLLBACK statement 5-123 


releasing 5-125 


releasing with COMMIT statement 5-29 


types of 5-111 
LOCK TABLE statement 
definition 5-111 to 5-112 
examples 5-112 
summary 5-4 
syntax 5-111, B-8 
Locks 
exclusive 5-140 
table 5-111 
LOGFILE 
option of CREATE DATABASE 5-48 
Logging off 
See RELEASE option 
Logging on 
See CONNECT statement 
Logical data independence 1-9 
Logical expression 1-4 
in WHERE clause 6-6 
Logical operator 
definition 4-5 
use in condition 4-42 
Logical unit of work 
definition 5-127 
See also transaction processing 
Login 
automatic 5-32 
LONG data 3-23 
LONG datatype 1-4, 3-16 to 3-17, 3-23 
compared to LONG RAW 3-17 
maximum characters 3-16 
restrictions on 3-16 
LONG RAW data 3-23 
LONG RAW datatype 1-4, 3-17, 3-23 
description of 3-17 
LONG VARCHAR data 3-23 
LONG VARCHAR datatype 3-17 





LONG VARGRAPHIC datatype 3-17 
LOWER 
character function 4-15 
LPAD 
character function 4-15 
LTRIM 
character function 4-16 


M 


M 
integer notation 3-13 
[AX 


group function 4-21 
MAXDATAFILES 

option of CREATE DATABASE 5-48 
MAXEXTENTS 

Storage clause option 5-138 
MAXINSTANCES 

option of CREATE DATABASE 5-48 
MAXLOGFILES 

option of CREATE DATABASE 5-48 
MAXTRANS 

CREATE TABLE option 5-69 
MAXVALUE 

option of CREATE SEQUENCE 5-58 
Memory 

caching sequence numbers 5-61 
MI date format element 4-37 
MI number format element 4-36 
MIN 


group function 4-21 
MINEXTENTS 

Storage clause option 5-138 
MINUS set operator 

in ORDER BY clause 6-11 

with SELECT statements 5-131 
MINVALUE 

option of CREATE SEQUENCE 5-58 
Miscellaneous operators 4-8 
MM date format element 4-36 
MOD 

number function 4-12 


Mode 

locking table into specified 5-111 
Model 

Entity Relationship 1-2 

Relational 1-1 
MON date format element 4-37 
Mono-directionality of VALIDATE INDEX 
5-145 
MONTH date format element 4-37 
MONTHS_BETWEEN date function 4-27 
Mount database 5-9 
Multiplication operator 4-2 


N 


Name 
database link 6-20 
for constraints 5-36 
Naming rules 
for database objects 3-3 
National Language Support 
NLSSORT function 4-20 
support for 2-4 
Navigation 
automatic 2-3 
ndex 


dropping an index owned by another user 


5-87 
Negative Scale 
definition of 3-11 
Nesting 1-4 
Network 1-4 
NEW_TIME 
date function 4-27 
NEXT 
Storage clause option 5-137 
NEXT_DAY 
date function 4-28 
NEXTVAL 
argument for sequences 5-61 
pseudo-column. 3-26 
restrictions on use 5-62 
use in expression 4-40 
used in same statement with CURRVAL 
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9 number format element 4-36 
NLSSORT 
character function 4-20 
function 2-4 
NOARCHIVELOG 
option of CREATE DATABASE 5-49 
NOAUDIT statement 
definition 5-113 to 5-114 
examples 5-113 to 5-114 
summary 5-4 
syntax 5-113 to 5-114, B-8 
NOAUDIT statement options 
See AUDIT statement 
Node 1-4 
Non-equi-join 1-5 
Normal exit from ORACLE 5-29 
Normalization 
Entity Relationship model 1-2 
NOSORT 
option of the CREATE INDEX statement 5-53 
to reduce index creation time 5-55 
[NOT] BETWEEN comparison operator 
definition 4-4 
[NOT] EXISTS comparison operator 
definition 4-4 
NOT EXISTS system option 
of AUDIT statement 5-22 
NOT FOUND 
WHENEVER statement condition 5-146 
[NOT] IN comparison operator 
definition 4-3 
examples 4-4 
{NOT] LIKE comparison operator 
definition 4-4 
NOT logical operator 
definition 4-5 
in WHERE clause 6-6 
NOT NULL 
column constraint 5-35 
NOT NULL clause 
ALTER TABLE statement 5-18 
NOT NULL option 
INSERT statement 5-107 


Index - 16 SQL Language Reference Manual 


NOWAIT 
LOCK TABLE option 5-111 
SELECT option 5-129 
NOWAIT option 
LOCK TABLE statement 5-112 
Null 1-5 
constraint, example 5-37 
constraint 5-37 
definition 3-25 
ina condition 4-43 
in an index 5-55 
NULL clause 
ALTER TABLE statement 5-18 
NULL option 
INSERT statement 5-107 
Null value 
COMMENT statement 5-28 
definition 3-25 
in ORDER BY clause 6-11 
Number 
comparison rules 3-20 
expression prefix sign 4-2 
format model 4-34, 4-36 
formats 4-36 
functions 4-12 
literal 3-8 
NUMBER datatype 1-5, 3-17 
description of 3-11 
maximum value 3-11 
Numeric overflow 
format 4-35 
NVL 
function 3-25, 4-32 


O 


Object 

naming database 3-2 
OFFLINE 

CREATE TABLESPACE option 5 
ON option 

REVOKE statement 5-121 
ONLINE 

CREATE TABLESPACE option 5-72 


72 





OPEN cursor statement 
definition 5-115 to 5-116 
embedded SQL syntax 5-115, B-8 
summary 5-4 

Open database 
ALTER DATABASE 5-9 

OPEN statement 
examples 5-116 

OPEN_LINKS 
INIT.ORA parameter 5-51 

Operating system 1-5 

Operator 1-5 
addition 4-2 
arithmetic 4-2 
character 4-3 
concatenation 1-2 
definition 4-2 
division 4-2 
logical 4-3, 4-5 
miscellaneous 4-8 
multiplication 4-2 
NOTIN 4-4 
rules, overriding 4-2 
set 4-6 
subtraction 4-2 
use in expression 4-39 

OR logical operator 
definition 4-5 
in WHERE clause 6-6 
truth table 4-6 

ORACLE 
distributed query 5-34 

ORACLE Precompilers 
embedded SQL 2-5 

Order 
of columns 1-4 
of index columns 5-53 
of sequence generation 5-59 
option of CREATE SEQUENCE 5-59 
with respect to rows 1-6 

ORDER BY 
to affect display order of rows 1-6 


ORDER BY clause 
definition 6-11 
LONG data in 3-16 
of SELECT statement 5-129, 5-131 
use with ROWNUM_ 3-26 
Outer column 
reference to in inner query 6-19 
Outer join 1-5, 6-15 
definition 6-14 
Overriding normal operator rules 4-2 


P 


P.M. date format element 4-37 

Page 1-5 

Parent node 
definition 3-27 

Parent query 1-5 

Parenthesis 
around expressions 4-41 

Parsing dynamic statements 
EXECUTE IMMEDIATE statement 5-95 
PREPARE statement 5-117 

Password 1-5 
changing with ALTER USER 5-21 
how to change 5-101 to 5-102 


specified during connection to ORACLE 5-32 
specifying with the GRANT statement 5-101 


Pattern matching 
definition 4-9 

PCTFREE option 
CREATE INDEX statement 5-54 
of CREATE INDEX statement 5-53 
of CREATE TABLE statement 5-67 


when combined with PCTUSED option 5-70 


PCTINCREASE 
storage clause option 5-138 
PCTUSED option 
CREATE TABLE statement 5-68 
of CREATE TABLE statement 5-68 


when combined with PCTFREE option 5-70 


Performance 
implicit datatype conversions 3-20 
Period number format element 4-36 
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Physical block 1-5 
Physical data independence 1-9 
Physical storage 
of tables in a cluster 5-43 
PM date format element 4-37 
POWER 
number function 4-13 
PR number format element 4-36 
Precedence 1-5 
definition 4-2 
Precision 3-11 
using 3-11 
Prefix in date formatting 4-37 
PREPARE statement 
definition 5-117 
embedded SQL statement 5-117 
embedded SQL syntax B-8 
examples 5-117 
summary 5-4 
used with SELECT statement 5-134 
PRIMARY 
column constraint 5-35 
constraint, example 5-38 
Primary key 1-5 
automatic generation with sequence numbers 
5-58 
definition of 1-10 
Entity Relationship model 1-2 
necessity of 1-10 
specifying a constraint 5-38 
system generated 1-12 
table of REFERENCES constraint 5-38 
Primary key:guidelines for creating 1-10 
PRIOR operator 4-8 
CREATE DATABASE LINK statement 5-51 
definition 4-8 
in CONNECT BY clause of SELECT statement 
5-130, 6-9 
Private 
rollback segment 5-57 
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Privilege 1-5 
passing on to another user 5-105 
provided by CONNECT 5-101 
provided by DBA 5-102 
provided by RESOURCE 5-101 
types of, for tables 5-104, 5-121 
Privileges 
granting on table 5-106 
Pseudo-column 1-5 
applying SELECT to A-7 
definition 3-26 
UID 4-32 
USER 4-33 
Pseudo-columns 5-61 
Public 1-5 
DROP DATABASE LINK clause 5-86 
DROP DATABASE LINK option 5-86 
DROP ROLLBACK SEGMENT option 5-88 
GRANT option 5-104 
granting resource to 5-103 
option of CREATE ROLLBACK SEGMENT 
5-57 
option of CREATE SYNONYM _ 5-64 
REVOKE option 5-121 
rollback segment 5-57 
PUBLIC option 
CREATE DATABASE LINK statement 5-50 
REVOKE statement 5-121 
Public synonym 
definition 5-64 
Punctuation in date formatting 4-37 I 





Q 


Q date format element 4-36 
Query 1-5 
and locks 5-112 
correlated 5-139, 6-19 
data locks allowing 5-111 
definition 6-16 to 6-17 
for CREATE TABLE 5-67 
ina view 5-74 
in conjunction with INSERT 5-107 
inner, definition 6-19 
remote 5-34 
results, specifying display order 6-11 
SELECT 5-128 
through database link, restrictions 5-51 
tree-structured, in database link 5-51 
unqualified columns in 6-19 
using ROWID 3-18 
Query optimizer 
SQL 2-3 
Quota 
per user for a tablespace 5-103 
Quoted string in date formatting 4-37 


R 


RAW data 3-23 
RAW datatype 1-6, 3-17, 3-23 
description of 3-17 
RAWTOHEX 
conversion function 4-24 
RDBMS 1-6 
Read consistency 1-6 
default 5-135 
READ ONLY 
DML statements prohibited in 5-135 
implementation 5-135 
SET TRANSACTION 5-135 
transaction 5-135 
Real number 3-14 
Record 1-6 
synonym for row 1-6 


Recovery 
with redo log files 5-9 
Redo log 
adding files to a database 5-9 
setting number of files with CREATE 
DATABASE 5-47 
REFERENCE 
foreign key column constraint 5-35 
REFERENCES 
example 5-40 
privilege 5-105 
REFERENCES clause 
Column constraint 1-12 
REFERENCES privilege 5-104 
Referential integrity 1-6 
definition of 1-13 
via views 1-7, 5-75 
Referential integrity rule 1-6 
Relation 1-6 
synonym for table 1-3 
Relational Database Management System 
definition 1-6 
Relationship 
Entity Relationship model 1-2 
RELEASE 
option of COMMIT 5-31 
ROLLBACK, embedded SQL 5-125 
RELEASE option 5-31 
ROLLBACK statement 5-125 
RELEASE_CURSOR option 
of ORACLE Precompilers 5-26 
Remote computer 1-6 
Remote database 1-6 
access via synonyms 5-64 
accessing datain 6-20 
and local database, creating link between 5-50 
declaration of 5-79 
logging onto 6-21 
Remote query 6-20 
Remote table 
identifying 6-20 
referencing 6-21 
Removing tables from a cluster 5-8 
Rename 
database or redo log 5-9 
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RENAME statement 
definition 5-118 
embedded SQL syntax 5-118 
examples 5-118 
summary 5-4 
syntax B-8 
REPLACE 
function 2-4 
Reserved word 1-6 
Reserved words 
definition of 3-5 
for datatypes 3-17 
RESOURCE database privilege 
in GRANT statement 5-101 
in REVOKE statement 5-119 
of AUDIT statement 5-22 
RESOURCE tablespace privilege 
granting 5-103 
in GRANT statement 5-103 
in REVOKE statement 5-120 
revoking 5-103 
Restarting sequence numbers 5-14 
Restrictions on distributed queries 6-21 
Retrieving rows from a table 
embedded SQL 5-133 
REUSE 
database file specification 5-10 
option of CREATE DATABASE 5-48 
tablespace file parameter 5-19 
Reversing effect of AUDIT 5-114 
REVOKE statement 
definition 5-119 to 5-122 
examples 5-119 to 5-120, 5-122 
summary 5-5 
syntax 5-119 to 5-121, B-8 
Rollback 
affect on AUDITing 5-23 
to asavepoint 5-126 
to the same savepoint multiple times 5-123 
Rollback segment 1-6 
creation 5-57 
example of creation 5-88 
read consistency implementation 5-136 
READ ONLY transaction 5-136 
returning space to tablespace 5-88 
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ROLLBACK statement 
definition 5-123 to 5-125 
embedded SQL syntax 5-125, B-8 
ending a transaction 5-123, 5-127 
examples 5-124 
releasing locks 5-131, 5-140 
summary 5-5 
syntax 5-123, 5-125, B-8 
Root 1-6 
ROUND 
date function 4-29 
number function 4-13 
Rounding 
after exceeding maximum scale 3-11 
Rounding numeric data 3-11 
Rounding of numeric data 
forcing via scale 3-11 
Row 1-6 
adding rows with embedded SQL INSERT 
5-109 
adding to table or view 5-107 
definition of 1-5 
deleting from table 5-81 
duplication of 1-5 
dynamic nature of 1-6 
FETCH 5-98 
inserting when a table is created 5-66 
order of 1-6 
removing rows with the DROP TABLE 
statement 5-91 
selecting from table 5-128 
table design 1-3, 1-5 
Row address 
See ROWID 
Row exclusive locks 5-111 
Row sequence number 
in ROWID 3-18 
Row share locks 5-111 
ROWID 
components of 3-18 
datatype 3-23 
description of 3-18 
pseudo-column 3-26 
uses for 3-18 





ROWID datatype 1-6 


ROWIDTOCHAR 
conversion function 4-25 
ROWNUM 
pseudo-column 3-26, 4-40 
Rows 


accessing via ROWID 3-18 
identifying via ROWID 3-18 
RPAD 


character function 4-17 
RTRIM 

character function 4-17 
RX locks 5-111 


S 


Savepoint 1-6 
erasing with COMMIT statement 5-29 
rollback 5-123 
ROLLBACK option 5-123 
ROLLBACK, embedded SQL 5-125 
use within an application 5-126 
SAVEPOINT statement 
definition 5-126 to 5-127 
embedded SQL syntax 5-126 
summary 5-5 
syntax 5-126, B-9 
SAVEPOINT statements 
examples 5-127 
Savepoints 
INIT.ORA parameter 5-126 
maximum active 5-126 
naming 5-126 
Scale 3-11 
negative 3-11 
using 3-11 
SCC date format element 4-36 
Scientific notation 
displaying numbers in 4-36 
Sco} 


pe 
of DECLARE STATEMENT statement 5-80 


synonym resolution 5-65 


WHENEVER embedded SQL statement 5-146 


search_condition 

in the WHERE clause 6-7 
Searching 

for rows with an index 5-53 
Security 

provided by views 5-75 

via views 1-7 
SELECT 

ORDER BY option 5-129 
SELECT clause 

applying to a pseudo-column A-7 

INSERT statement 5-107 

UPDATE statement 5-140 to 5-141 
SELECT lists 

using LONGs in 3-16 
SELECT object privilege 5-105 
SELECT statement 

clauses 6-1 

definition 5-128 to 5-134 

embedded SQL examples 5-134 

embedded SQL syntax 5-133, B-9 

examples 5-132 

summary 5-5 

syntax 5-128, 5-133, B-9 
Sequence 1-6 

auditing 5-59 

auditing access to 5-24 

creation 5-58 to 5-63 

defaults 5-60 

dropping 5-59 

exporting/importing 5-60 

generation 5-62 

in SELECT 5-132 

independence from tables 5-60 

losing numbers 5-61 

negative increment 5-58 


NOAUDIT parameters 5-104, 5-114, 5-121 


performance implications of 5-60 
restarting 5-89 
skipping numbers 5-60 





Sequence numbers 
caching 5-59 
exporting/importing 5-60 
first 5-58 
increment between 5-14, 5-58 
MAXVALUE 5-58 
MAXVALUE, MINVALUE 5-14 
MINVALUE 5-58 
turning on/off CACHE 5-14 
turning on/off ORDER 5-14 
Session 1-6 
SESSIONID 
USERENV option 4-33 
Set 
attribute of a table 1-6 
SET clause 
UPDATE statement 3-16, 5-140 
Set condition 1-7 
Set operation 1-7 
Set operator 4-6 
SET TRANSACTION statement 
definition 5-135 to 5-136 
examples 5-136 
summary 5-5 
syntax 5-135, B-9 
Share lock 1-7 
Share locks 5-111 
Share row exclusive locks 5-111 
Share update lock 1-7 
Share update locks 5-111 
Sharing access to table 5-111 
SIGN 
number function 4-13, 
Simple join 6-13 
Simultaneous update and query against same 
tables 5-135 
SIZE 
database file specification 5-10 
tablespace file parameter 5-19 
SIZE clause 
of CREATE CLUSTER statement 5-44 
SMALLINT datatype 3-17 
Sort 
in CREATE INDEX 5-53 
when creating index 5-55 
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SOUNDEX 1-7 
character function 4-17 
SP date format suffix 4-38 
Space 
estimating usage within a table 1-6 
reclamation after a DELETE 5-81 
reclamation when a table is dropped 5-91 
reclamation when an index is dropped 5-87 
Space allocation 
for tables 5-66 
SPTH date format suffix 4-38 
SQL 1-7 
benefits of 2-3 
definition of 2-1 
embedded 2-5 
history of 2-2 
language for all users 2-3 
National Language Support 2-4 
ORACLE lexical conventions 2-7 
query optimizer 2-3 
standardization 2-2 
unified language 2-4 
/*_*/ (SQL comment) 5-2, 5-6 
SQL standard 
from ANSI 1-14 
SQL*Net 1-7 
database string 2-6 
using 5-50, 6-20 to 6-21 
SOL*Net string 5-50 
SQL/DS 
and SQL 2-2 
datatypes 3-17 
SQL/DS datatypes 3-17 
SQLCA 
See also entries under individual components 
SQLCODE 
not found 5-83, 5-99, 5-134, 5-143 
SQLERROR 
WHENEVER statement condition 5-146 
SQLROWS 
for UPDATE 5-143 
with DELETE 5-83 
sqlwarn(S) 5-83 
SQLWARNING 
WHENEVER statement condition 5-146 


SORT 
number function 4-14 
SRX locks 5-111 
SS date format element 4-37 
SSSSS date format element 4-37 
Standard deviation 
STDDEV function 4-22 
START WITH clause 
CREATE DATABASE LINK statement 5-51 
definition 6-9 
of CREATE SEQUENCE statement 5-58 
of SELECT statement 5-129 to 5-130, 6-10 
Statement 1-2 
executing immediately with embedded SQL 
5-95 
FETCH 5-98 
parsing with EXECUTE IMMEDIATE 5-95 
READ ONLY transaction 5-135 
statement_name 2-6 
STDDEV 
numeric function 4-22 
STOP 
WHENEVER statement action 5-146 
Storage 
allocation for rollback segments 5-57 
ALTER ROLLBACK SEGMENT 5-13 
ALTER TABLE 5-17 
ALTER TABLESPACE 5-19 
CREATE TABLE option 5-69 
index blocks 5-12 
option of CREATE ROLLBACK SEGMENT 
5-57 
Storage clause 
definition 5-137 to 5-138 
example 5-138 
syntax 5-137, B-9 
Subquery 1-7 
See Correlated query 
See also query 
SELECT 5-132 
through database link, restrictions 5-51 


SUBSTR 

character function 4-18 
Subtraction operator 4-2 
Suffixes in date formatting 4-38 


group function 4-22 
Suppressing blank padding 
date formatting 4-37 
SYEAR date format element 4-36 
Synonym 1-7 
auditing access to 5-24, 5-114 
creating for table or view 5-64 
deleting from database 5-90 
DROP TABLE statement 5-91 
DROP VIEW statement 5-93 
example 5-65, 5-90 
how to alter 5-90 
how to drop 5-90 
how to drop a synonym owned by another 
user 5-90 
public 5-64 
renaming 5-118 
use with database link 5-51 
when the underlying table is dropped 5-91 
Synonyms 
grants on 5-105 
Syntax 1-7 
SYSCATALOG Data Dictionary view 
COMMENT statement 5-28 
SYSCOLUMNS Data Dictionary view 
COMMENT statement 5-28 
SYSDATE 
function 3-15 
SYSTEM 
default tablespace 5-73 
System R 
development of 2-2 
SYYYY date format element 4-36 
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Table 1-7 


access privileges, revoking 5-119 to 5-121 
adding comments to 5-28 

adding new column to definition 5-18 
adding row to 5-107 

adding rows with embedded SQL INSERT 
5-109 

adding to cluster 5-42 

advantage of 1-3 

alias 5-129, 6-2 

asaset 2-3 

auditing access to 5-24 

benefits of good design 1-2 

changing field value in 5-139 
checking integrity of index 5-145 
clustering 5-66 

column 1-2 

creating 3-17 

creating index for 5-52 

deleting from database 5-91 

deleting rows from 5-81 

DROP VIEW statement 5-93 
dropping another user’s table 5-91 
Entity Relationship model 1-2 
example of dropping 5-91 

example tables 1-15 

granting access to 5-104 

granting privileges on 5-106 
guidelines for creating 1-3 

inserting comment about into Data Dictionary 
5-28 

inserting rows into during CREATE TABLE 
5-66 

locking 5-111 

LONG columns per 3-16 

name, creating synonym 5-64 

name, qualifying 6-2 

NOAUDIT parameters 5-114 
ordering 5-129 

removing from a cluster 5-85 
renaming 5-118 

selecting row or column from 5-128 
sharing access 5-111 
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space allocation 5-66 
specifying the tablespace 5-66 
storage allocation 5-137 
structure 1-3 
when tablespace is dropped 5-92 
Table alias 5-140 
Table alias: 1-7 
Table column 1-7 
Table constraint 1-7, 5-66 
definition 1-14, 5-35 to 5-41, B-9 
example 5-41 
for primary key 1-10 
syntax 5-35 
Table, remote 
See Remote table 
Tablespace 1-7 
adding/renaming database files 5-19 
changing a user’s default 5-21 
changing future storage allocations 5-19 
CREATE TABLE option 5-69 
creating rollback segments for 5-57 
default temporary segments for a user 5-21 
deleting rollback segments from 5-88 
dropping 5-73 
example of creation 5-73 
example of dropping 5-92 
for a table 5-66 
granting resource to 5-103 
indicate the begin/end of backup 5-19 
option of CREATE ROLLBACK SEGMENT 
5-57 
putting on/off line 5-19 
removal from database 5-92 
rollback segments for 5-73 


. Temporary segment 1-7 


TERMINAL 

USERENV option 4-33 
Text 

definition of 3-10 
TH date format suffix 4-38 
Theory, relational 1-1 
THSP date format suffix 4-38 


Time 
24 hour format 3-15 
default 3-15 
entering 3-15 
ignoring for date comparisons 3-15 
zones 4-27 
Time zones 4-27 
TO_CHAR 
conversion function 4-25 
example of 4-34 
TO_CHAR function 3-16 
format model in 4-34 
TO_DATE 
conversion function 4-26 
format models 4-36 
TO_DATE function 3-15 
format model in 4-34 
TO_NUMBER 
conversion function 4-26 
definition 4-35 
Transaction 1-7 
committing before disconnect 5-29 
committing work of 5-29 
defining savepoints 5-126 
definition 5-29, 5-123, 5-127 
ended by ROLLBACK statement 5-123 
ending a READ ONLY transaction 5-135 
ending with COMMIT statement 5-29 
logging modes 5-47 
read consistency 5-135 
READ ONLY 5-135 
READ ONLY implementation 5-135 
rollback 5-123 
Transaction entry 
within a block 5-12 
Transaction processing 
COMMIT statement 5-31 
ROLLBACK statement 5-123 to 5-125 
SAVEPOINT statement 5-126 to 5-127 


SET TRANSACTION statement 5-135 to 5-136 


Translate 
function & pattern matching 4-10 
character function 4-18 


Tree-structured query 1-7 


CREATE DATABASE LINK statement 5-51 


TRUE 

result of a condition 4-42 
TRUNC 

date function 4-29 

number function 4-14 
Truth tables 4-5 to 4-6 
Tuple 1-7 

synonym for row 1-6 


U 


UID 
pseudo-column 4-32 
Undo a transaction 5-123 
UNION 
set operator 4-6 
UNION set operator 
in ORDER BY clause 6-11 
with SELECT statements 5-131 
UNIQUE 
column constraint 5-35 
Unique key 1-8 

definition of 1-12 
UNIQUE option 

of CREATE INDEX statement 5-52 
Uniqueness of rows 

enforced with an index 1-8 
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publication. Your input is an important part of the information used for revision. 


¢ Did you find any errors? 

* Isthe information clearly presented? 
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« Are the examples correct? Do you need more examples? 
« What features did you like most about this manual? 


If you find any errors or have any suggestions for improvement, please indicate the topic, chapter, 
and page number below: 























Please send your comments to: 


ORACLE RDBMS Product Manager 
Oracle Corporation 

500 Oracle Parkway 

Redwood Shores, CA 94065 

(415) 506-7000 
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